Centro de ayudaGitHub

Comprar una etiqueta

POST Comprar

Compra una etiqueta en borrador.

Compra con monedero: El importe se deduce de tu monedero de atoship. rate en la respuesta = lo que pagaste.

Compra BYOCA: Cuando el borrador tiene un carrier_account_id, el envío se crea mediante tus propias credenciales de transportista. rate en la respuesta = la tarifa cotizada del transportista. No se cobra a tu monedero de atoship el coste del envío: el transportista factura directamente a tu cuenta de transportista (o al tercero que especificaste mediante billing).

Facturación a terceros (solo UPS): Establece billing.payer = "third_party" con el número de cuenta UPS, el país y el código postal del tercero. UPS facturará a esa cuenta en lugar de a la tuya. Este es el patrón estándar para integraciones ERPNext/ERP donde los costes de envío se trasladan a la propia cuenta UPS del cliente.

Autorización: Al enviar una solicitud de facturación a terceros, confirmas que el tercero te ha autorizado a facturar a su cuenta UPS. atoship registra la marca de tiempo de la autorización para auditoría/resolución de disputas.

Parámetros

Parámetros de ruta

id string Obligatorio
ID de etiqueta de POST /v1/labels. Debe estar en estado draft.

Parámetros del cuerpo (opcional)

billing object
Anula o proporciona la facturación en el momento de la compra. Misma estructura que billing en POST /v1/labels. Tiene prioridad sobre la facturación guardada en el borrador.

payer: shipper | recipient | third_party
accountNumber: Obligatorio para recipient/third_party
countryCode: ISO de 2 letras. Obligatorio para third_party
postalCode: Obligatorio para third_party

Devuelve

200 Correcto
401 No autorizado
500 Error interno del servidor

Relacionado

Labels
POST/api/v1/labels/[id]/purchase