Guías

Sincronizar tus pedidos

Que los pedidos de Primters entren solos en tu sistema y se actualicen al enviarlos.

Es el uso más habitual: que los pedidos de Primters entren solos en tu sistema y que, al enviarlos desde allí, se actualicen en Primters.

1. Cada 5 minutos, pide los pedidos que han cambiado con GET /orders?updated_since=…, usando la fecha guardada la vez anterior. La primera vez, usa por ejemplo la de hace 30 días.
2. Recorre todas las páginas mientras has_more sea true.
3. Crea o actualiza cada pedido en tu sistema, buscándolo por su id. Un mismo pedido llegará varias veces, una por cada cambio.
4. Guarda el updated_at del último pedido recibido para la próxima vez, solo cuando todo haya ido bien.
5. Confirma a tiempo los pedidos pending. Tienes hasta confirm_before; si no, se cancelan solos.
6. Al enviar un pedido desde tu sistema, llama a marcar como enviado con la agencia y el seguimiento.

Script de ejemplo

# Pedidos que han cambiado desde la última vez
curl "https://europe-west1-primters-web.cloudfunctions.net/api/v1/orders?updated_since=2026-12-03T19:12:40.000Z&limit=100" \
  -H "Authorization: Bearer $PRIMTERS_API_KEY"

# Si has_more es true, pide la página siguiente con starting_after
curl "https://europe-west1-primters-web.cloudfunctions.net/api/v1/orders?updated_since=2026-12-03T19:12:40.000Z&limit=100&starting_after=Xk2pQ9aLm3" \
  -H "Authorization: Bearer $PRIMTERS_API_KEY"

Qué significa cada estado

¿Dudas o necesitas algo que no está? Escríbenos a contacto@primters.com indicando, si es un error, la petición que haces y la respuesta que recibes (sin la clave).