Skip to main content
POST
/
api
/
v1
/
orders
Crear Pedidos
curl --request POST \
  --url https://api.zenflow.com.ar/api/v1/orders \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "order_tenant_id": "<string>",
  "assembly_date": "<string>",
  "customer_name": "<string>",
  "shipping_address": "<string>",
  "order_detail": [
    {
      "barcode": "<string>",
      "quantity": 123,
      "price": 123
    }
  ]
}
'
{
  "success": true,
  "data": {
    "created_count": 123,
    "existing_count": 123,
    "orders": [
      {}
    ]
  }
}

​
Crear Pedidos

Crea uno o múltiples pedidos para fulfillment.
Requiere scope write:orders.

​
Solicitud

POST /api/v1/orders

​
Parámetros del Body

Puedes enviar un pedido individual o un array de pedidos.
​
order_tenant_id
string
required
Tu identificador único de pedido (usado para idempotencia)
​
assembly_date
string
required
Fecha en que el pedido debe ser preparado (YYYY-MM-DD)
​
customer_name
string
Nombre del cliente
​
shipping_address
string
Dirección de envío
​
order_detail
array
required
Array de líneas de pedido

​
Respuesta

​
success
boolean
Si la solicitud fue exitosa
​
data
object

​
Ejemplos

​
Pedido Individual

curl -X POST "https://api.zenflow.com.ar/api/v1/orders" \
  -H "X-API-Key: zenflow_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "order_tenant_id": "ORD-001",
    "assembly_date": "2024-01-15",
    "customer_name": "Juan Pérez",
    "shipping_address": "Av. Corrientes 1234, CABA",
    "order_detail": [
      {
        "barcode": "7891234567890",
        "quantity": 2,
        "price": 29.99
      },
      {
        "barcode": "7891234567891",
        "quantity": 1,
        "price": 49.99
      }
    ]
  }'

​
Múltiples Pedidos

curl -X POST "https://api.zenflow.com.ar/api/v1/orders" \
  -H "X-API-Key: zenflow_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "orders": [
      {
        "order_tenant_id": "ORD-001",
        "assembly_date": "2024-01-15",
        "order_detail": [{"barcode": "7891234567890", "quantity": 2}]
      },
      {
        "order_tenant_id": "ORD-002",
        "assembly_date": "2024-01-15",
        "order_detail": [{"barcode": "7891234567891", "quantity": 1}]
      }
    ]
  }'

​
Respuesta Exitosa

{
  "success": true,
  "data": {
    "created_count": 2,
    "existing_count": 0,
    "orders": [
      {
        "id": 12345,
        "order_tenant_id": "ORD-001",
        "state_id": 1
      },
      {
        "id": 12346,
        "order_tenant_id": "ORD-002",
        "state_id": 1
      }
    ]
  }
}

​
Respuestas de Error

​
400 Error de Validación

{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "Datos de pedido inválidos",
    "details": [
      {
        "index": 0,
        "error": "assembly_date es requerido"
      }
    ]
  }
}

​
400 Producto No Encontrado

{
  "success": false,
  "error": {
    "code": "creation_error",
    "message": "Producto con código de barras 7891234567890 no encontrado"
  }
}