DocumentaciónCatálogos de referencia

Catálogos de referencia

Mixto (tipocambio público)

Datos de apoyo para cotizar y facturar: tipo de cambio, sucursales, países, estados, colonias, formas de pago, paqueterías y uso de CFDI.

GET/api/v1/tipocambio

Tipo de cambio

Público

Tipo de cambio vigente (normal, preferencial y por plazos) para convertir precios a pesos. Es público: no requiere token.

curl 'https://developers.syscom.mx/api/v1/tipocambio'

Códigos de estado

200

Tipo de cambio vigente.

404

No hay tipo de cambio disponible.

500

Error interno.

GET/api/v1/sucursales

Sucursales

Bearer

Lista las sucursales de Syscom en México, con su nombre e identificador.

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

Códigos de estado

200

Lista de sucursales.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso (gate de distribuidor).

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/carrito/paises

Países

Bearerscope: carrito

Países disponibles para las direcciones de envío.

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

Códigos de estado

200

Catálogo de países.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o scope `carrito` insuficiente.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/carrito/estados/{cp}

Estado por código postal

Bearerscope: carrito

Devuelve el estado y el municipio que corresponden a un código postal.

curl 'https://developers.syscom.mx/api/v1/carrito/estados/31000' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

cpstringrequerido

Código postal (4-5 dígitos).

Códigos de estado

200

Estado/municipio del código postal.

400

Código postal inválido (no 4-5 dígitos).

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o scope `carrito` insuficiente.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/carrito/colonias/{cp}

Colonias por código postal

Bearerscope: carrito

Lista las colonias de un código postal.

curl 'https://developers.syscom.mx/api/v1/carrito/colonias/31000' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

cpstringrequerido

Código postal (4-5 dígitos).

Códigos de estado

200

Colonias del código postal.

400

Código postal inválido (no 4-5 dígitos).

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o scope `carrito` insuficiente.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/carrito/pago

Métodos de pago

Bearerscope: carrito

Formas de pago disponibles para el pedido (transferencia, pago en sucursal, crédito, etc.), con su descuento y plazo.

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

Códigos de estado

200

Catálogo de métodos de pago.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o scope `carrito` insuficiente.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/carrito/fleteras

Fleteras

Bearerscope: carrito

Paqueterías disponibles para el envío, indicando cuáles ofrecen entrega al día siguiente.

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

Códigos de estado

200

Catálogo de fleteras.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o scope `carrito` insuficiente.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/carrito/cfdi

Usos de CFDI

Bearerscope: carrito

Usos de CFDI disponibles para la facturación del pedido.

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

Códigos de estado

200

Catálogo de usos de CFDI.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o scope `carrito` insuficiente.

429

Límite de peticiones excedido.

500

Error interno.