Tu primera orden.
Un paso a la vez.

PASO 01 · CONFIGURACIÓN

Preparar el tenant y el acceso

Antes de enviar datos, asegurate de trabajar con la empresa y el ambiente correctos.

1. En Administrar tenant → Nueva integración, elegí eCommerce. Confirmá que la empresa corresponde a la tienda.
2. Identificá la tienda y el backend acordado. Configurá los secretos únicamente en sus campos protegidos, nunca en nombres, URLs, capturas o manuales.
3. Solicitá una credencial técnica de prueba de AGo vinculada a esa empresa y mantenela en tu backend. Registrar Auth Token en el tenant no emite una credencial ni demuestra que sea válida.
4. Dejá ¿Activo? desmarcado hasta validar el circuito. Guardar la ficha no instala un conector de Shopify ni confirma sincronización.
5. Prepará un cliente, productos, moneda y tasas de IVA reales del entorno de prueba. No uses los identificadores ilustrativos siguientes sin reemplazarlos.

PASO 02 · CREACIÓN

Crear la primera orden

Desde tu backend: POST {{base_url}}/orders, con Content-Type: application/json. Confirmá la URL del ambiente de prueba. Ejemplo ilustrativo, no ejecutado:

{
  "token": "TOKEN_TECNICO_DE_PRUEBA",
  "orden": {
    "configurations": {
      "NuevoUpdate": 1,
      "IdExterno": "TIENDA-PRUEBA-0001",
      "Cliente": 999,
      "ClienteDsc": "CLIENTE DE PRUEBA",
      "IdMon": 0,
      "Payment": {"pending": true, "total": 100, "shipping": 0, "discounts": {"total": 0}}
    },
    "items": [
      {"sku": "SKU-PRUEBA", "Articulo": "Producto de prueba", "cantidad": 1,
       "preciounitario": 100, "PorCenIva": 22, "modifiers": []}
    ]
  }
}

Reemplazá token, Cliente, IdMon, SKU y PorCenIva con valores autorizados del entorno. NuevoUpdate: 1 solicita creación; IdExterno identifica la compra externa. Payment.pending: true evita presentar este ejemplo como cobrado.

Control de resultado: revisá HTTP y el JSON, no solo el código HTTP. Una respuesta de creación contiene status: true e IdVenta. Guardá ese identificador y la referencia externa en tu sistema.

PASO 03 · UN CASO MÁS COMPLETO

Varios artículos y un descuento

Usá la misma estructura anterior, otra referencia externa para una compra diferente y estos componentes. No son un cuerpo completo por sí solos:

"Payment": {"pending": true, "total": 190, "shipping": 0, "discounts": {"total": 10}}

"items": [
  {"sku": "SKU-A", "Articulo": "Producto A", "cantidad": 1,
   "preciounitario": 100, "PorCenIva": 22, "modifiers": []},
  {"sku": "SKU-B", "Articulo": "Producto B", "cantidad": 2,
   "preciounitario": 50, "PorCenIva": 22, "modifiers": []}
]

Comprobación: 100 + (2 × 50) − 10 = 190. Los ejemplos mantienen shipping en cero: el controlador revisado tiene comprobaciones financieras diferentes para envío, por lo que no damos por validado ese caso. Modificadores y medios de pago requieren sus propios IDs y pruebas.

PASO 04 · COMPROBACIÓN

Leer y comprobar la orden

Para la consulta puntual: POST {{base_url}}/orders/get, con el mismo token técnico de la empresa:

{"token": "TOKEN_TECNICO_DE_PRUEBA", "idventa": 12345}

Reemplazá 12345 con el IdVenta recibido. Consultá los campos de respuesta vigentes en API completa → Órdenes. Abrí Gestión de Órdenes y verificá cliente, artículos, moneda, importe y estado de pago.

• Recibida: existe una IdVenta; no significa facturada.
• Reintento: una compra debe conservar su IdExterno. El controlador consulta la referencia y puede responder Orden ya procesada con la IdVenta existente. Verificá que solo haya una orden; la concurrencia también requiere una prueba.
• Facturación: se gestiona desde la orden. Una orden guardada no confirma emisión ni aceptación fiscal.

PASO 05 · CIERRE DEL RECORRIDO

Resolver incidencias y preparar la activación

• Token vencido o inexistente: revisar la credencial técnica y su empresa; no sustituirla por una sesión personal.
• Orden inválida, sin items o sin SKU: corregir la estructura y campos indicados.
• Cliente requerido: usar un cliente válido de la empresa.
• Inconsistencia de total: revisar cantidad × precio, descuentos y Payment.total.
• Rechazo fiscal: revisar el resultado del comprobante desde la orden; no crear otra compra para ocultar el rechazo.

Antes de activar: demostrar una creación, consulta y reintento sin duplicados; validar el estado de pago y el circuito fiscal cuando corresponda. Registrar evidencia sin secretos. Activar únicamente la integración acordada para la empresa, con autorización.

Base de esta guía: rutas locales de Órdenes y validaciones de OrdersController/AuthController. Son ejemplos de contrato; la aceptación en el servidor publicado y el uso del token independiente aún requieren prueba controlada.