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 (por defecto solo se devuelven las 30 guías más recientes).

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

Parámetros de consulta

facturasstring (CSV)

?facturas=FA99/123,FA99/456Opcional. Lista de folios separados por comas.

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. El costo de envío se muestra por separado en `envio`; el subtotal ya no lo incluye.

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

Parámetros

idstringrequerido

FA26/000000 -> URL_ENCODEDFolio de la factura o del pedido (576-000000/26). La petición espera el folio como string URI-encoded: la diagonal / se envía como %2F.

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). El costo de envío se muestra por separado en `envio`; el subtotal ya no lo incluye.

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 Marcas