Quickstart

Arista Delivery expone una interfaz REST/JSON estable. Tu sistema solo necesita una credencial del ambiente correspondiente y un identificador de idempotencia para las operaciones que crean o modifican recursos.

1. Autenticación

Envía la credencial como Bearer token. No compartas claves en URLs, capturas ni repositorios.

Authorization: Bearer ari_test_...Copiar

2. Crea un envío TEST

curl -X POST \
  'https://arista.delivery/sandbox-api/v1/shipments' \
  -H 'Authorization: Bearer ari_test_...' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: order-12345' \
  -d '{
    "recipient": {
      "name": "Cliente Demo",
      "phone": "55555555",
      "address": "Zona 10",
      "municipality": "Guatemala"
    },
    "pickup": {"address": "San Marcos", "municipality": "San Marcos"},
    "package": {"content": "Pedido", "pieces": 1, "weight_lbs": "2.00"},
    "cod": {"amount": "0.00"}
  }'Copiar

3. Idempotencia

Para crear y cancelar envíos debes enviar Idempotency-Key. Si tu sistema reintenta la misma operación con la misma clave y los mismos datos, Arista evita crear duplicados.

4. Request ID

Toda respuesta incluye request_id y el header X-Arista-Request-Id. Consérvalo en tus logs; es la referencia de soporte para una solicitud concreta.

5. Seguridad de ambientes

Una credencial TEST no funciona en LIVE y una LIVE no funciona en TEST. El Sandbox no debe utilizarse como fuente de datos productivos.