Pedidos
Pedidos
Estados de un pedido y todos sus campos.
Al comprar, el comprador solo autoriza el pago. Se cobra cuando confirmas el pedido y se libera si lo cancelas o se acaba el plazo para confirmarlo.
Estados
pending → in_progress → shipped → delivered → completedpending → cancelled
pending | Recién pagado. Tienes que confirmarlo o cancelarlo antes de confirm_before; si no, se cancela solo y se libera el pago. |
in_progress | Confirmado: se ha cobrado y está en preparación. |
shipped | Enviado, con su seguimiento. |
delivered | Entregado. |
completed | Cerrado. Lo confirma el comprador o se cierra solo 7 días después de enviarlo o entregarlo, si no hay una reclamación abierta. |
cancelled | Cancelado. El pago no se cobra o se devuelve. |
El objeto pedido
| Campo | Tipo | Descripción |
|---|---|---|
id | texto | Identificador del pedido. |
object | texto | Siempre order.Valores: order. |
status | texto | Estado del pedido (ver los estados).Valores: pending, in_progress, shipped, delivered, completed, cancelled. |
created_at | fecha | Cuándo se hizo el pedido. |
updated_at | fecha | Último cambio del pedido. Es la fecha que hay que usar para sincronizar. |
confirm_before | fechao null | Hasta cuándo puedes confirmarlo. Solo en pedidos pending. |
confirmed_at | fechao null | Cuándo se confirmó. |
shipped_at | fechao null | Cuándo se marcó como enviado. |
delivered_at | fechao null | Cuándo se marcó como entregado. |
completed_at | fechao null | Cuándo se cerró. |
cancelled_at | fechao null | Cuándo se canceló. |
customer | objeto | Comprador. Su correo no se comparte: la comunicación va por el chat de Primters. |
customer.name | textoo null | Nombre del comprador. |
customer.phone | textoo null | Teléfono, para la agencia de transporte. |
delivery | objeto | Entrega del pedido. |
delivery.method | texto | Envío a domicilio o recogida en mano.Valores: shipping, pickup. |
delivery.address | objetoo null | Dirección de envío. Vacía si es recogida en mano. |
delivery.address.name | textoo null | Destinatario. |
delivery.address.street | textoo null | Calle, número, piso y puerta. |
delivery.address.additional_info | textoo null | Datos adicionales de la dirección. |
delivery.address.postal_code | textoo null | Código postal. |
delivery.address.city | textoo null | Localidad. |
delivery.address.province | textoo null | Provincia. |
delivery.address.country | textoo null | País (código ISO de dos letras). |
delivery.pickup_location | textoo null | Punto de recogida, si es recogida en mano. |
delivery.estimated_date | textoo null | Fecha de entrega estimada. |
note | textoo null | Nota del comprador para ti. |
items | lista | Productos del pedido. |
items[].product_id | textoo null | Identificador del producto. |
items[].title | textoo null | Nombre del producto en el momento de la compra. |
items[].reference | textoo null | Tu referencia del producto, si la tiene. |
items[].quantity | enteroo null | Cantidad (unidades o lotes, según quantity_mode). |
items[].quantity_mode | texto | Si la cantidad son unidades o lotes.Valores: units, lots. |
items[].lot_size | enteroo null | Unidades de cada lote, si se vende por lotes. |
items[].unit_price | númeroo null | Precio unitario sin IVA. |
items[].total | númeroo null | Total de la línea sin IVA, con extras. |
items[].customization | lista de textos | Opciones de personalización elegidas, en texto (por ejemplo, «Color: blanco»). |
items[].addons | lista | Extras añadidos. |
items[].addons[].name | textoo null | Nombre del extra. |
items[].addons[].price | númeroo null | Precio del extra sin IVA. |
items[].image_url | URLo null | Foto del producto. |
items[].design_preview_url | URLo null | Vista previa del diseño del comprador, si lo hizo en el diseñador. |
amounts | objeto | Importes del pedido, en euros. |
amounts.currency | texto | Moneda (ISO 4217). |
amounts.subtotal | númeroo null | Productos, sin IVA. |
amounts.discount | número | Descuento de un cupón sobre los productos, sin IVA (0 si no hay). |
amounts.primts | número | Descuento pagado con Primts (los puntos de los compradores), sin IVA. Lo pone Primters: no rebaja lo que cobras (0 si no hay). |
amounts.shipping | númeroo null | Envío, sin IVA. |
amounts.tax_rate | númeroo null | Tipo de IVA en tanto por uno (0.21 es un 21 %). |
amounts.tax | númeroo null | IVA. |
amounts.total | númeroo null | Total del pedido con IVA, ya con el descuento del cupón. |
amounts.gift_card | número | Parte del total pagada con una tarjeta regalo (0 si no hay). |
amounts.commission | númeroo null | Comisión de Primters. |
amounts.payout | númeroo null | Lo que recibes tú. |
amounts.refunded | número | Importe devuelto al comprador. |
coupon | objetoo null | Cupón o tarjeta regalo usado en la compra, si lo hay. |
coupon.code | textoo null | Código. |
coupon.type | textoo null | Porcentaje, importe fijo o tarjeta regalo.Valores: percent, amount, gift. |
coupon.funded_by | texto | Quién pone el descuento. Si es Primters, cobras el pedido como si no lo hubiera; si es tuyo, la comisión se calcula sobre el total descontado.Valores: primters, maker. |
tracking | objetoo null | Seguimiento del envío. Vacío hasta que se marca como enviado. |
tracking.carrier | textoo null | Agencia de transporte. |
tracking.number | textoo null | Número de seguimiento. |
tracking.url | URLo null | Enlace de seguimiento. |
cancellation | objetoo null | Datos de la cancelación. Solo en pedidos cancelled. |
cancellation.by | textoo null | Quién lo canceló.Valores: maker, admin, system. |
cancellation.reason | textoo null | Motivo. |
dispute | objetoo null | Reclamación del comprador, si la hay. |
dispute.status | texto | Estado de la reclamación. |
panel_url | URL | Pedidos en tu panel de Primters. |
Los archivos de impresión de los diseños hechos en el diseñador se descargan desde el panel. La API da la vista previa del diseño en design_preview_url.
¿Dudas o necesitas algo que no está? Escríbenos a contacto@primters.com indicando, si es un error, la petición que haces y la respuesta que recibes (sin la clave).
