Sucursales
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Otro lugar desde donde factura el emisor, con su propio código postal: sus facturas llevan ese CP en LugarExpedicion (y su zona horaria en la Fecha, y el IVA 8 % si es de la franja fronteriza), su dirección en el PDF y, si las da, sus propias series. Un CP que ya tiene otra sucursal contesta branch_exists; el del domicilio fiscal del emisor no es sucursal (es la Matriz). Hasta 200 por emisor.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
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/jsonissuer?stringEl emisor (iss_…). Por omisión, su único emisor.
name*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.
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' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "name": "Sucursal Monterrey", "zip": "64000", "address": { "street": "Av. Constitución", "exterior": "1500", "neighborhood": "Centro", "city": "Monterrey" }, "phone": "81 1234 5678", "series": { "invoice": "MTY" }}'{ "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"}