Ir al contenido
Sucursales

FISCALISTO / API / REFERENCIA

Ver una sucursal

Abrir en ChatGPTAbrir en Claude
GET
/v1/branches/{id}

Una sucursal del emisor.

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de la ruta

id*string

El id del objeto.

Cuerpo de la respuesta

Correcto.

application/json
  1. response

Una sucursal del emisor: otro lugar desde donde factura, con su código postal (LugarExpedicion), su dirección en el PDF y sus series.

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

object*string

Qué tipo de objeto es («invoice», «customer»…).

issuer*string

El emisor de la sucursal.

name*string

Cómo la llama su equipo; va en el PDF.

zip*string

Su 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*boolean

true 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 GET 'https://api.fiscalisto.com/v1/branches/string' \  -H 'Authorization: Bearer fk_test_…'
{  "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"}

Crear una sucursal POST

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.

Actualizar una sucursal POST

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.