Skip to navigation

Detalle de orden

Detalle completo de una orden.

Campos clave

CampoDescripción
idNúmero de orden.
statusEstado actual (ver la tabla de estados en la guía Órdenes).
creationDateFecha de creación.
marketplace.nameEcommerce donde se compró (Promart, Oechsle, plazaVea…).
items[].idId del SKU vendido.
items[].quantity / items[].priceCantidad y precio unitario.
items[].commissionComisión referencial (la definitiva se calcula en la liquidación).
items[].priceTags[]Descuentos aplicados. promotionUserType: SELLER (asumido por ti) o ADMIN (asumido por el marketplace).
clientProfileDataDatos del cliente. El teléfono viene enmascarado. isCorporate: true si solicitó factura (ver corporateName y corporateDocument = RUC).
shippingData.addressDirección de entrega, enmascarada salvo receiverName. Los datos completos llegan en el webhook ORDER_READY_FOR_HANDLING. postalCode es el ubigeo.
shippingData.logisticsInfo[].selectedSlaEmpieza con Envío a domicilio o Retiro en tienda, seguido de un id entre paréntesis.
shippingData.logisticsInfo[].deliveryCompanyTipo de despacho asignado (p. ej. ENVIO DD LIMA).
shippingData.logisticsInfo[].shippingEstimateDateFecha límite de entrega.
value / totals[]Total pagado y su desglose (items, descuentos, envío).
controversies[]Controversias abiertas (ver tipos en Webhooks).
updateHistory[]Historial de cambios de estado.
paymentMethodMedio de pago.
paymentProofNombre del comprobante subido (<orderId>-<AAAAMMDDHHmm>.pdf); null si aún no se sube.

Authentication

AuthorizationBearer

accessToken obtenido en Login. Dura 24 horas.

Path parameters

orderIdstringRequired

Número de orden.

Response

Orden lista para atender
idstringOptional
marketplacePaymentValuedoubleOptional
itemslist of objectsOptional
clientProfileDataobjectOptional
shippingDataobjectOptional
openTextFieldanyOptional
creationDatestringOptional
statusstringOptional
packageAttachmentanyOptional
valuedoubleOptional
totalslist of objectsOptional
accountNamestringOptional
controversiesanyOptional
liquidatedanyOptional
punishmentanyOptional
marketplaceobjectOptional
tagslist of anyOptional
updateDatestringOptional
updateHistorylist of objectsOptional
paymentMethodstringOptional
paymentProofanyOptional

Errors

400
Bad Request Error