{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/es/v2/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","img"]},"type":"markdown"},"seo":{"title":"Guía de parámetros para funciones adicionales"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"guía-de-parámetros-para-funciones-adicionales","__idx":0},"children":["Guía de parámetros para funciones adicionales"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cómo proporcionar los datos del formulario de aduanas"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cómo declarar el seguro del envío"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cómo incluir información de materiales peligrosos"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-cómo-proporcionar-los-datos-del-formulario-de-aduanas","__idx":1},"children":["🛃 Cómo proporcionar los datos del formulario de aduanas"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Firmante"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signing_person"]}," (obligatorio)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","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."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Detalles de la mercancía"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_data_list"]}," (obligatorio)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Proporciona un arreglo de líneas de artículos. Todos los campos son obligatorios, excepto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hs_tariff_number"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quantity"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["origin"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["weight"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unit_cost"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["weight_unit"]}," — obligatorios"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hs_tariff_number"]}," — opcional (recomendado)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tipo de contenido y opción de no entrega"]}," - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content_type"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["undeliverable_option"]}," (obligatorio)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","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."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cumplimiento de exportación de EE. UU. (EEI)"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eel_pfc_type"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eel_pfc_code"]}," (opcional)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Proporciona uno de los siguientes pares según el valor total del envío:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valor > $2500 (ITN obligatorio)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"eel_pfc_type\": \"ITN\",\n\"eel_pfc_code\": \"X20240427123456\"\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valor ≤ $2500 (usa un código de exención)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"eel_pfc_type\": \"EXEMPTION_CODE\",\n\"eel_pfc_code\": \"NOEEI 30.37(a)\"\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Por defecto:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eel_pfc_type"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXEMPTION_CODE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eel_pfc_code"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOEEI 30.37(a)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IDs fiscales"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_ids"]}," (opcional)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","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."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"-cómo-declarar-el-seguro-del-envío","__idx":2},"children":["💰 Cómo declarar el seguro del envío"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Si quieres asegurar tu envío, debes declarar el valor asegurado en USD."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Paso 1 – Obtén una cotización de seguro"]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Llama al endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/insurance/rate"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Proporciona el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_level"]}," y el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["declared_value"]}," en la solicitud."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La cotización devuelta está vinculada directamente tanto al nivel de servicio como al valor declarado que proporciones."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Paso 2 – Compra el seguro junto con el envío"]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Al comprar la etiqueta, incluye el objeto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["insurance_data"]}," en la solicitud a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/create_and_pay"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/shipment/shein/direct_buy"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Notas importantes"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Si el nivel de servicio cambia entre la cotización y la compra, la solicitud de compra del seguro fallará."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["El valor declarado determina el monto de la cobertura en caso de pérdida o daño."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"️-cómo-incluir-información-de-materiales-peligrosos","__idx":3},"children":["☠️ Cómo incluir información de materiales peligrosos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para declarar un envío como contenedor de materiales peligrosos:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Establece el campo"]}," ","En el campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["option_data.hazardous_materials"]},", pasa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."," ","Esta opción solo es compatible con envíos que usan el nivel de servicio USPS Ground Advantage."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/hazmat_label.6fd035a9538133ce70f015f9e2fcc765acfe0d31a9fedb17740576af30e3ab64.c5aff763.png","alt":"Image description","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Documentación de referencia"]}," ","Para más información sobre las reglas, clasificaciones y restricciones del envío de materiales peligrosos, consulta: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.shipsaving.com/blog/hazardous-shipping-101-with-usps"},"children":["Hazardous Shipping 101 with USPS"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Guía de parámetros para funciones adicionales","id":"guía-de-parámetros-para-funciones-adicionales","depth":2},{"value":"🛃 Cómo proporcionar los datos del formulario de aduanas","id":"-cómo-proporcionar-los-datos-del-formulario-de-aduanas","depth":3},{"value":"💰 Cómo declarar el seguro del envío","id":"-cómo-declarar-el-seguro-del-envío","depth":3},{"value":"☠️ Cómo incluir información de materiales peligrosos","id":"️-cómo-incluir-información-de-materiales-peligrosos","depth":3}],"frontmatter":{"seo":{"title":"Guía de parámetros para funciones adicionales"}},"lastModified":"2026-08-26T18:17:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/es/v2/parameterguide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}