Sucursales
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Cambia solo los campos que manda; una serie en null vuelve a la del emisor. archived: true la archiva (ya no se factura desde ella y sus facturas la siguen nombrando), false la restaura. El código postal de una sucursal que ya facturó no cambia: si se mudó, archívela y cree otra.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
Idempotency-Key?stringOpcional (los SDK la mandan solos). Si la respuesta se pierde, repita la solicitud con el mismo valor durante 24 horas: contesta lo mismo, con idempotent-replayed: true, y no lo hace dos veces (ni crea, ni manda correos, ni cobra).
1 <= length <= 255application/jsonname?stringCómo la llama su equipo, por ejemplo «Sucursal Monterrey». Va en el PDF.
1 <= length <= 60zip?stringSu código postal (LugarExpedicion de sus CFDI): uno por sucursal, distinto del domicilio fiscal del emisor.
^\d{5}$address?La dirección que va en el PDF de sus facturas.
phone?|Teléfono, para el PDF.
email?|Correo, para el PDF.
series?Serie (Serie), hasta 25 caracteres. Cada serie lleva sus propios folios.
archived?booleantrue la archiva: ya no se puede facturar desde ella, y sus facturas la siguen nombrando. false la restaura.
Correcto.
application/jsonUna sucursal del emisor: otro lugar desde donde factura, con su código postal (LugarExpedicion), su dirección en el PDF y sus series.
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
object*stringQué tipo de objeto es («invoice», «customer»…).
issuer*stringEl emisor de la sucursal.
name*stringCómo la llama su equipo; va en el PDF.
zip*stringSu código postal: el LugarExpedicion de sus CFDI.
address*Su dirección, en el PDF de sus facturas.
phone*|Teléfono, en el PDF, o null.
email*|Correo, en el PDF, o null.
series*La serie de cada tipo de CFDI que se timbra desde ella; null usa la del emisor.
archived*booleantrue si está archivada: ya no se factura desde ella.
created_at*|Cuándo se creó.
updated_at*|Cuándo cambió por última vez.
curl -X POST 'https://api.fiscalisto.com/v1/branches/string' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "archived": true}'{ "id": "brn_OufpKqnrvx9p3", "object": "branch", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "name": "Sucursal Monterrey", "zip": "64000", "address": { "street": "Av. Constitución", "exterior": "1500", "interior": null, "neighborhood": "Centro", "city": "Monterrey", "state": "Nuevo León" }, "phone": "81 1234 5678", "email": null, "series": { "invoice": "MTY", "credit_note": null, "payment": null, "transfer": null }, "archived": false, "created_at": "2026-10-27T09:12:00-06:00", "updated_at": "2026-10-27T09:12:00-06:00"}