Esta sección describe los parámetros adicionales necesarios para escenarios de envío especiales al usar las APIs de Obtener tarifa (Get Rate) y Compra directa de etiqueta (Direct Buy Label). Sirve como referencia para asegurar que se proporcione toda la información necesaria para un cálculo de tarifa preciso y una creación exitosa de la etiqueta. Los temas incluyen:

• Cómo proporcionar los datos del formulario de aduanas

• Cómo declarar el seguro del envío

• Cómo incluir información de materiales peligrosos

Los formularios de aduanas suelen ser necesarios para envíos internacionales o envíos a ciertos territorios de EE. UU. y direcciones especiales, como Guam, Puerto Rico y direcciones militares de EE. UU. (APO/FPO/DPO). Estos destinos se tratan como internacionales en el sistema postal y requieren información de declaración aduanera.

• Firmante - signing_person (obligatorio)
  Nombre completo de la persona que firma el formulario de declaración aduanera. Es un campo obligatorio y suele ser el remitente o un representante autorizado.

• Detalles de la mercancía — item_data_list (obligatorio)
  Proporciona un arreglo de líneas de artículos. Todos los campos son obligatorios, excepto hs_tariff_number.

  • description, quantity, origin, weight, unit_cost, weight_unit — obligatorios
  • hs_tariff_number — opcional (recomendado)

• Tipo de contenido y opción de no entrega - content_type y undeliverable_option (obligatorio)
  Indica qué contiene el envío y cómo manejar los artículos no entregables. Los valores válidos del enum se definen en la referencia de la API.

• Cumplimiento de exportación de EE. UU. (EEI) — eel_pfc_type y eel_pfc_code (opcional)
  Proporciona uno de los siguientes pares según el valor total del envío:

  • Valor > $2500 (ITN obligatorio)
  "eel_pfc_type": "ITN",
  "eel_pfc_code": "X20240427123456"

  • Valor ≤ $2500 (usa un código de exención)
  "eel_pfc_type": "EXEMPTION_CODE",
  "eel_pfc_code": "NOEEI 30.37(a)"

  Por defecto: eel_pfc_type = EXEMPTION_CODE, eel_pfc_code = NOEEI 30.37(a)

• IDs fiscales — tax_ids (opcional)
  IDs fiscales específicos de cada país para el despacho aduanero. Obligatorios para envíos a México; en otros casos, opcionales (depende del destino). Los tipos/enums y formatos se listan en la referencia de la API.

Si quieres asegurar tu envío, debes declarar el valor asegurado en USD.

1. Paso 1 – Obtén una cotización de seguro

• Llama al endpoint /api/shipment/insurance/rate.
• Proporciona el service_level y el declared_value en la solicitud.
• La cotización devuelta está vinculada directamente tanto al nivel de servicio como al valor declarado que proporciones.

2. Paso 2 – Compra el seguro junto con el envío

• Al comprar la etiqueta, incluye el objeto insurance_data en la solicitud a /api/shipment/create_and_pay o /api/shipment/shein/direct_buy.
• El service_level utilizado en este paso debe coincidir exactamente con el service_level usado en el Paso 1 al obtener la cotización; cualquier discrepancia resultará en un error.

Para declarar un envío como contenedor de materiales peligrosos:

1. Establece el campo En el campo option_data.hazardous_materials, pasa true. Esta opción solo es compatible con envíos que usan el nivel de servicio USPS Ground Advantage.

2. Visualización en la etiqueta Cuando se declaran materiales peligrosos, la etiqueta de envío generada tendrá una visualización/marcado especial. Consulta la imagen a continuación para ver un ejemplo del formato de la etiqueta.

3. Documentación de referencia Para más información sobre las reglas, clasificaciones y restricciones del envío de materiales peligrosos, consulta: Hazardous Shipping 101 with USPS.