Registrar Pedido

Número de pedido (debe ser único)

Código de la modalidad

Código de la marca

Información del destinatario

Información del origen. Identificación del punto de origen — debe enviar uno de estos modos (excluyentes):

1. point_code — código del local de origen (si se envía, los demás campos de ubicación son ignorados).
2. ubigeo — código INEI del distrito.
3. region + province + city — jerarquía completa (los tres campos juntos; jerarquía parcial es inválida).

Si envía ubigeo no envíe la jerarquía, y viceversa.

Información del destino. Identificación del punto de destino — debe enviar uno de estos modos (excluyentes):

1. point_code — código del local de destino (si se envía, los demás campos de ubicación son ignorados).
2. ubigeo — código INEI del distrito.
3. region + province + city — jerarquía completa (los tres campos juntos; jerarquía parcial es inválida).

Si envía ubigeo no envíe la jerarquía, y viceversa.

Número de documento de referencia

Código del canal de venta

Número de seguimiento personalizado. Si no se envía, se generará uno automáticamente.

Cantidad de paquetes del pedido. Su comportamiento depende de la configuración de la cuenta integrada:

• Si la cuenta genera sus propios LPNs: debe coincidir exactamente con la cantidad de packages[] que tengan lpn definido.
• Si DINET genera los LPNs: es obligatorio (define cuántos LPNs emitirá DINET); si además se envía packages[] con datos específicos sin lpn, la cantidad debe coincidir con este valor.

Valor declarado del pedido. Opcional, y puede enviarse sin order_currency_code.

Código de moneda del pedido (ISO 4217, 3 letras, case-insensitive). Opcional. Solo puede enviarse junto con order_price: una moneda sin un monto al que acompañar se rechaza.

Categoría de tamaño del paquete

Fecha estimada de entrega

Permite confirmar automáticamente el pedido. Si se omite, se asume false por defecto.

Peso total del pedido en kilogramos

Volumen total del pedido en metros cúbicos

Observaciones adicionales del pedido

Información del remitente

Información de pago. Si se envía payment, amount es obligatorio; el resto de sus campos son opcionales.

Lista de paquetes (bultos físicos) del pedido.

Emparejamiento con los artículos: cada paquete se relaciona con los artículos que contiene mediante correlative_id; el paquete y sus artículos comparten el mismo valor. Es un identificador local al request (no es un ID de negocio ni se almacena) y debe ser único entre los packages[].

Un artículo cuyo correlative_id no coincida con ningún paquete —o cuando no se envía packages[]— se agrupa en un paquete aparte. El código LPN de cada paquete (enviado o autogenerado) depende de la configuración de la cuenta; ver el campo lpn.

Ejemplo — el paquete 1 contiene los artículos ART001 y ART002; el artículo ART003 se agrupa en un paquete aparte:

  { "correlative_id": 1, "lpn": "LPN001" }
], "items": [
  { "correlative_id": 1, "code": "ART001", "name": "Smartphone", "quantity": 1 },
  { "correlative_id": 1, "code": "ART002", "name": "Funda",      "quantity": 2 },
  { "correlative_id": 3, "code": "ART003", "name": "Cargador",   "quantity": 1 }
] ```

Lista de artículos del pedido. Cada artículo se asigna a un paquete repitiendo en su correlative_id el valor del package correspondiente en packages[]. Ver el modelo de emparejamiento y el ejemplo en packages.