Quickstart (10 minutos)

Necesitás la API key de sandbox que te entregó Xenda (formato xnd_...). En los ejemplos, reemplazá $KEY por tu key.

La sucursal demo ya tiene catálogo cargado y un pedido pendiente esperándote — tu primer GET /v1/orders devuelve un pedido real.

1. Mirá el pedido pendiente

curl "https://api.automationhub.one/api:07fkGLk_/v1/orders?status=pendiente" \
  -H "X-API-Key: $KEY"

Vas a recibir algo así — las lineas vienen con tus códigos (codigo), listas para matchear contra tu base:

{
  "orders": [
    {
      "order_id": 83,
      "status": "pendiente",
      "delivery_type": "delivery",
      "delivery_address": "Av. Cabildo 1234, 3B, CABA",
      "domicilio": {
        "calle": "Av. Cabildo", "numero": "1234", "piso_depto": "3B",
        "localidad": "CABA", "referencia": "tocar timbre 3B"
      },
      "cliente": {
        "nombre": "Maria Demo", "telefono": "+549...",
        "telefono_pais": "54", "telefono_area": "11", "telefono_numero": "40723113"
      },
      "pago": { "modo": "en_entrega", "pagado": false, "monto": 14500 },
      "costo_envio": 0,
      "total": 14500,
      "lineas": [
        {
          "codigo": "1003", "nombre": "1/2 Kilo",
          "cantidad": 1, "precio_unitario": 9500, "subtotal": 9500,
          "opciones": [
            { "codigo": "S05", "nombre": "Frutilla" },
            { "codigo": "S06", "nombre": "Limon" }
          ]
        },
        { "codigo": "3001", "nombre": "Palito bombon", "cantidad": 2, "subtotal": 5000, "opciones": [] }
      ]
    }
  ]
}

Qué puede venir en null — tratá estos campos como opcionales y poné tu propio valor por defecto:

delivery_address y todo el objeto domicilio (calle, numero, piso_depto, localidad, referencia): en retiro por el local (delivery_type: "pick_up") vienen todos en null; en envíos, piso_depto y referencia son opcionales, y si el domicilio no pudo separarse los campos vienen null con el texto completo en delivery_address.
cliente.nombre: si el cliente no dio su nombre — mostrá “Cliente”.
cliente.telefono_pais / telefono_area / telefono_numero: null solo en pedidos anteriores a julio 2026; los nuevos vienen siempre poblados.
lineas[].codigo y opciones[].codigo: null si el producto o sabor se cargó a mano en Xenda (sin código tuyo). Con el catálogo sincronizado desde tu POS, siempre vienen.

Todo lo demás viene siempre con valor: pago.modo default "en_entrega", pago.pagado default false, pago.monto y costo_envio default 0.

2. Aceptalo

curl -X POST "https://api.automationhub.one/api:07fkGLk_/v1/orders/83/status" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{
    "event_id": "mi-evento-001",
    "occurred_at": "2026-07-30T12:00:00-03:00",
    "status": "aceptado"
  }'

Respuesta: {"order_id": 83, "status": "en_preparacion"} — aceptar mueve el pedido directo a en preparación (y en producción dispara la notificación de WhatsApp al cliente).

3. Marcalo listo y entregado

curl -X POST "https://api.automationhub.one/api:07fkGLk_/v1/orders/83/status" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"event_id": "mi-evento-002", "occurred_at": "2026-07-30T12:20:00-03:00", "status": "listo"}'

curl -X POST "https://api.automationhub.one/api:07fkGLk_/v1/orders/83/status" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"event_id": "mi-evento-003", "occurred_at": "2026-07-30T12:45:00-03:00", "status": "entregado"}'

4. Empujá un cambio de precio

curl -X POST "https://api.automationhub.one/api:07fkGLk_/v1/catalog/items" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{
    "event_id": "mi-evento-004",
    "occurred_at": "2026-07-30T13:00:00-03:00",
    "action": "upsert",
    "items": [
      { "codigo": "1001", "nombre": "Kilo de helado", "categoria": "Helados",
        "precio": 16000, "deshabilitado": false }
    ]
  }'

Respuesta: {"accepted": 1, "rejected": [], "skipped_stale": 0}. Desde ese momento el bot cotiza el kilo a $16.000.

Alta y modificación son el mismo request: es un upsert por codigo. Si el codigo no existe lo creamos, si existe lo actualizamos — la distinción la hacemos nosotros. Mandá siempre el objeto completo del producto.

5. Probá los reintentos (idempotencia)

Repetí el request anterior con el mismo event_id:

# misma llamada que el paso 4 → {"duplicate": true, "accepted": 0, ...}

Nada se reprocesa. Ante cualquier duda de red, reintentar con el mismo event_id es siempre seguro.

6. Auditá tus sincronizaciones

curl "https://api.automationhub.one/api:07fkGLk_/v1/sync-log" -H "X-API-Key: $KEY"

Cada corrida de catálogo y cada cambio de estado que hiciste queda registrado, con los ítems rechazados y el motivo si algo falló.

Eso es todo el ciclo. Los detalles finos (estados, transiciones válidas, reglas de sincronización) están en Estados del pedido y en la referencia de la API.

Empezar

API Reference

1. Mirá el pedido pendiente

2. Aceptalo

3. Marcalo listo y entregado

4. Empujá un cambio de precio

5. Probá los reintentos (idempotencia)

6. Auditá tus sincronizaciones

​1. Mirá el pedido pendiente

​2. Aceptalo

​3. Marcalo listo y entregado

​4. Empujá un cambio de precio

​5. Probá los reintentos (idempotencia)

​6. Auditá tus sincronizaciones

1. Mirá el pedido pendiente

2. Aceptalo

3. Marcalo listo y entregado

4. Empujá un cambio de precio

5. Probá los reintentos (idempotencia)

6. Auditá tus sincronizaciones