Documentación de la API de Fixy.

Todas las llamadas requieren tu token de integración. Lo obtenés desde tu ejecutivo de cuenta o el portal de sellers. Podés enviarlo como header Authorization o como parámetro api_token.

$ curl https://api.fixy.com.ar/v2/tracking/AR-1842.json \
  -H "Authorization: Token TU_TOKEN"

Mantené tu token del lado del servidor. No lo expongas en el frontend ni en repositorios públicos.

La versión va en la ruta (/v1, /v2). Se mantiene la compatibilidad dentro de cada versión mayor; los cambios que rompen compatibilidad se publican bajo una versión nueva con aviso previo. Recomendamos usar siempre /v2.

Devuelve las opciones de envío disponibles y el tiempo estimado para un origen y destino. Ideal para mostrar opciones en el checkout.

Parámetros

$ curl -X POST https://api.fixy.com.ar/v2/cotizacion.json \
  -H "Authorization: Token TU_TOKEN" \
  -d '{ "cp_origen": "1414", "cp_destino": "5000", "peso": 1.2 }'

[
  { "servicio": "NEXT_DAY", "entrega": "24-48h" },
  { "servicio": "SAME_DAY", "entrega": "en el día" }
]

Genera una guía de envío. Devuelve el número de guía, su estado inicial y el enlace a la etiqueta.

Parámetros

$ curl -X POST https://api.fixy.com.ar/v2/guias.json \
  -H "Authorization: Token TU_TOKEN" \
  -d '{ "servicio": "NEXT_DAY", "cp": "1636", "referencia": "ORD-9021" }'

{
  "guia": "AR-1842",
  "estado": "PENDIENTE_ARMADO",
  "etiqueta": "https://api.fixy.com.ar/v2/etiquetas/AR-1842.pdf",
  "referencia": "ORD-9021"
}

Devuelve la etiqueta lista para imprimir de una guía. Disponible en PDF y en formato para impresoras térmicas (ZPL).

$ curl https://api.fixy.com.ar/v2/etiquetas/AR-1842.pdf \
  -H "Authorization: Token TU_TOKEN" -o etiqueta.pdf

Devuelve el estado actual de un envío, su historial de eventos y la estimación de entrega.

$ curl https://api.fixy.com.ar/v2/tracking/AR-1842.json \
  -H "Authorization: Token TU_TOKEN"

{
  "guia": "AR-1842",
  "estado": "EN_DISTRIBUCION",
  "eta": "hoy 14-18h",
  "historial": [
    { "estado": "EN_CAMINO", "ts": "2026-07-20T18:32:00-03:00" }
  ]
}

Solicita el retiro de paquetes en tu domicilio o depósito para una fecha y franja horaria.

$ curl -X POST https://api.fixy.com.ar/v2/retiros.json \
  -H "Authorization: Token TU_TOKEN" \
  -d '{ "fecha": "2026-07-21", "franja": "AM", "guias": ["AR-1842"] }'

Genera una recepción de mercadería para ingresar stock a Fixy Full (fulfillment). Devuelve el remito y el turno asignado.

$ curl -X POST https://api.fixy.com.ar/v2/recepciones.json \
  -H "Authorization: Token TU_TOKEN" \
  -d '{ "items": [ { "sku": "REM-NEG-M", "cantidad": 50 } ] }'

Consulta el stock disponible y reservado de un SKU en Fixy Full.

$ curl "https://api.fixy.com.ar/v2/stock?sku=REM-NEG-M" \
  -H "Authorization: Token TU_TOKEN"

{ "sku": "REM-NEG-M", "disponible": 42, "reservado": 3 }

En lugar de consultar el estado repetidamente (polling), Fixy envía un POST a la URL que configures cada vez que una guía cambia de estado. Respondé con 200 para confirmar la recepción.

{
  "evento": "cambio_estado",
  "guia": "AR-1842",
  "estado": "ENTREGADO",
  "referencia": "ORD-9021",
  "pod": { "foto": true, "dni": true, "geo": true },
  "ts": "2026-07-20T19:07:00-03:00"
}

Cada webhook incluye una firma en el header para que verifiques que la llamada proviene de Fixy.

El ciclo de vida típico de una guía. Los nombres finales de cada estado se confirman con el equipo técnico.

La API usa códigos de estado HTTP estándar. El cuerpo incluye un error con un mensaje descriptivo.

Antes de salir a producción, podés probar toda la integración contra un entorno de prueba con un token de sandbox: generás guías, disparás webhooks y validás tus respuestas sin afectar tu operación real. También publicamos una colección de Postman para acelerar los primeros llamados.