Sucursales de un cliente

Un cliente con varias sucursales recibe sus documentos en direcciones distintas, y muchas veces en correos distintos. Como el registro del cliente sólo guarda una dirección y un correo, facturar “a la sucursal de Zona 10” obligaba a re-escribir esos datos en cada documento. Con las sucursales, se registran una vez y después se emite nombrando la sucursal.

Se registran a mano — no se derivan

Las sucursales de un cliente las registra usted. No se pueden deducir de los documentos que emite, porque el bloque Receptor del DTE no tiene ningún concepto de establecimiento: sólo lleva identificación, nombre, correo y dirección del receptor.

Es lo contrario de las sucursales de un proveedor, que sí vienen en el documento recibido y aparecen automáticamente.

Registrar una sucursal

curl -X POST "https://api.fegora.com/cliente/512/sucursal" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Zona 10",
    "codigo": "Z10",
    "direccionCorreoElectronico": "zona10@cliente.example",
    "direccion": "10 Av 11-66 zona 10",
    "municipio": "Guatemala",
    "departamento": "Guatemala",
    "codigoPostal": "01010",
    "pais": "GT"
  }'

Campo	Requerido	Descripción
`nombre`	Sí	Cómo llama usted a la sucursal: “Zona 10”, “Bodega Central”. Es lo que se elige en una lista.
`codigo`	No	Su propio código interno (“Z10”, “CEDIS”). Único por cliente cuando se envía.
`direccionCorreoElectronico`	No	Correo de esa sucursal. La razón principal por la que esto es una entidad aparte.
`nombreComercial`, `telefono`	No
`direccion`, `municipio`, `departamento`, `idMunicipio`, `idDepartamento`, `codigoPostal`, `pais`	No	Dirección de la sucursal.
`notas`	No

Método	Ruta	Qué hace
`GET`	`/cliente/{id}/sucursal`	Lista las sucursales del cliente. Paginado, con búsqueda por `termino`.
`POST`	`/cliente/{id}/sucursal`	Registra una sucursal.
`PATCH`	`/cliente/sucursal/{idSucursal}`	Edita una sucursal. Envíe `activo: false` para retirarla.
`DELETE`	`/cliente/sucursal/{idSucursal}`	Retira la sucursal (retiro lógico).

Emitir a una sucursal

Al crear el DTE, indique la sucursal en el receptor:

{
  "receptor": { "idSucursal": 12 },
  "items": [
    { "descripcion": "Servicios profesionales", "precioUnitario": 1500 }
  ]
}

Eso es suficiente. Fegora arma el bloque receptor así:

la identidad (identificación fiscal y nombre) sale del cliente al que pertenece la sucursal — una sucursal no es un contribuyente distinto;
la dirección y el correo salen de la sucursal;
lo que la sucursal no tenga, lo aporta el cliente.

Lo que usted envía siempre gana

El campo es aditivo. Si además de idSucursal envía un campo explícito, ese valor se usa; la sucursal sólo rellena lo que faltaba:

{
  "receptor": {
    "idSucursal": 12,
    "correoElectronico": "otro@cliente.example"
  }
}

Aquí el documento va a otro@cliente.example, pero la dirección sigue siendo la de la sucursal 12.

Un valor vacío ("") cuenta como ausente, de modo que un formulario que envía cadenas vacías en los campos que no se tocaron se comporta igual que uno que los omite.

Los clientes que ya envían el bloque receptor completo no cambian en nada: si no manda idSucursal, no hay sucursal que resolver y todo se comporta como siempre.

No es un dato fiscal

La sucursal no viaja al XML como establecimiento del receptor — ese nodo no existe en el estándar. Sólo decide qué valores llenan la dirección y el correo del receptor. Por eso introducirla no cambia la validación del certificador ni del fisco. El documento sí queda marcado con la sucursal a la que se emitió, para poder consultar después los documentos de una sucursal en particular.

Errores

Código	Cuándo
`FEG_DTE_CREA_SUC_001`	La sucursal no existe, está inactiva o no pertenece a su Cuenta.
`FEG_CLI_SUC_CREA_INEX`	El cliente no existe o no pertenece a su Cuenta.
`FEG_CLI_SUC_CREA_001`	Ya existe una sucursal con ese `codigo` para ese cliente.
`FEG_CLI_SUC_ACTU_INEX`	La sucursal no existe o no pertenece a su Cuenta.
`FEG_CLI_SUC_ACTU_001`	Otra sucursal del mismo cliente ya usa ese `codigo`.

Un idSucursal que no se puede resolver es un error, no se ignora en silencio: emitir a la dirección por omisión produciría un documento fiscal dirigido al lugar equivocado.

Sucursal retirada

Una sucursal retirada (activo: false) deja de poder usarse al emitir — deja de alimentar direcciones a documentos nuevos, que es justamente para lo que se retira — pero los documentos que ya la referenciaron la conservan.

Introducción

Documentos DTE

Guías por país

Sucursales de un cliente

Se registran a mano — no se derivan

Registrar una sucursal

Emitir a una sucursal

Lo que usted envía siempre gana

No es un dato fiscal

Errores

Sucursal retirada

​Se registran a mano — no se derivan

​Registrar una sucursal

​Emitir a una sucursal

​Lo que usted envía siempre gana

​No es un dato fiscal

​Errores

​Sucursal retirada

Se registran a mano — no se derivan

Registrar una sucursal

Emitir a una sucursal

Lo que usted envía siempre gana

No es un dato fiscal

Errores

Sucursal retirada