Facturas

Bearer

Facturas del cliente, guías de envío y el detalle de cada factura. Solo consulta.

GET/api/v1/facturas

Listado de facturas

Bearer

Lista las facturas del cliente con el avance de su entrega. Puedes filtrar por año o por folio. Solo consulta.

curl 'https://developers.syscom.mx/api/v1/facturas?anio=2026&pagina=1' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros de consulta

anionumber

Año a consultar (rango 01-ene → 31-dic). Default: año actual. Se ignora si se envía `busqueda`.

paginanumber

Página (15 por página). Default 1.

busquedastring

Anula `anio`. Año (`2026`), año-mes (`2026-04`) o fecha (`2026-04-29`) → filtra por rango de fecha; cualquier otro texto → filtra por folio / folio_pedido (LIKE prefijo).

Códigos de estado

200

Listado paginado (puede venir vacío).

401

Token ausente, inválido, expirado o revocado.

403

Distribuidor sin acceso a la API.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/facturas/guias

Guías de envío

Bearer

Lista las guías de envío del cliente. Puedes pedir las de facturas específicas o las más recientes.

curl 'https://developers.syscom.mx/api/v1/facturas/guias' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros de consulta

facturasstring (CSV)

Folios específicos separados por coma (p. ej. `FA26/000000,FA26/000001`). Quita el límite de 30.

Códigos de estado

200

Arreglo de guías (puede venir vacío).

401

Token ausente, inválido, expirado o revocado.

403

Distribuidor sin acceso a la API.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/facturas/{id}

Detalle de factura

Bearer

Muestra el detalle completo de una factura: datos de envío, guías, productos y totales. Búscala por su folio.

curl 'https://developers.syscom.mx/api/v1/facturas/000000' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

idstringrequerido

Folio o folio_pedido de la factura (sin slash o URL-encoded).

Códigos de estado

200

Detalle fiscal de la factura.

401

Token ausente, inválido, expirado o revocado.

403

Distribuidor sin acceso a la API.

404

Factura no encontrada para este cliente.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/facturas/{anio}/{id}

Detalle por prefijo + folio

Bearer

Igual que el detalle de factura, pero para folios que incluyen el año (por ejemplo FA26/000000).

curl 'https://developers.syscom.mx/api/v1/facturas/FA26/000000' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

aniostringrequerido

Prefijo del folio (p. ej. `FA26`).

idstringrequerido

Parte numérica del folio (p. ej. `000000`).

Códigos de estado

200

Detalle fiscal de la factura.

401

Token ausente, inválido, expirado o revocado.

403

Distribuidor sin acceso a la API.

404

Factura no encontrada para este cliente.

429

Límite de peticiones excedido.

500

Error interno.

AnteriorCarrito Siguiente Pedidos