Calcular un Landed Cost

El partyCreateWorkflowInput identifica las partes involucradas y sus ubicaciones. Vea el esquema completo en la referencia de nuestra API GraphQL. Los campos requeridos son:

• location
  • administrativeAreaCode: El código de estado o provincia, en dos letras. Solo requerido para CA y BR.
  • countryCode: El código ISO de dos letras del país.
  • line1: La primera línea de la dirección.
  • postalCode: El código postal de la dirección.
• person
  • email: La dirección de correo electrónico de la persona.
  • firstName: El nombre de la persona.
  • lastName: El apellido de la persona.
  • phone: El número de teléfono de la persona.
• type
  • DESTINATION: La información de location y person para el destino de envío.
  • ORIGIN: La información de location para el origen de envío. No se requiere la person asociada con el origen de envío.

El itemCreateWorkflowInput enumera los artículos del carrito. Hay muchos campos opcionales (vea todas las posibilidades en nuestra referencia de API), pero los campos a continuación son obligatorios.

• amount: El valor de una sola unidad del producto que se envía, antes de multiplicarse por la cantidad. Tenga en cuenta que esto difiere de la definición postal de un artículo postal. Si la quantity del artículo es 1, este es el costo total del artículo. Si la quantity del artículo es >1, la API multiplicará el amount del artículo por la quantity del artículo para obtener el total de la línea. No coloque el precio total de todas las unidades del artículo en amount.
• currencyCode: El código de moneda del monto del artículo.
• quantity: La cantidad del artículo. La API multiplicará el amount del artículo por la quantity del artículo para obtener el total de la línea.
• countryOfOrigin: El país donde se fabricó el artículo.
• Uno de los siguientes (el que esté configurado como su preferencia de clave de artículo. Su clave de artículo conecta la información almacenada en Catalog con el artículo del carrito y se utiliza durante la creación de etiquetas.)
  • productId: El ID de producto del artículo.
  • sku: El SKU del artículo.

Las measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) solo son obligatorias si desea cartonizar sus artículos al obtener una tarifa de envío.

El cartonsCreateWorkflowInput solo requiere la entrada en sí. Vea el esquema completo en la referencia de nuestra API GraphQL para ver todos los valores que se pueden pasar. Es importante pasar las dimensiones y el peso del cartón si Zonos está calculando el costo de envío.

Este flujo de trabajo se utiliza cuando ya conoce el servicio y el costo de envío; si desea que Zonos calcule estos costos para los servicios que ha habilitado, reemplace este flujo de trabajo y use shipmentRatingCalculateWorkflow en su lugar.

El shipmentRatingCreateWorkflowInput comunica el costo de envío. Vea el esquema completo en la referencia de nuestra API GraphQL. Los campos requeridos son:

• amount: El costo de envío.
• currencyCode: El código de moneda del costo de envío.
• serviceLevelCode: El código que indica el nivel de servicio de envío utilizado en la tarifa de envío.

El landedCostWorkFlowInput dicta las preferencias para el cálculo de Landed Cost. Vea el esquema completo en la referencia de nuestra API GraphQL. Los campos requeridos son:

• calculationMethod: Indica su preferencia sobre cómo planea enviar: DDP (aranceles e impuestos prepagados) o DAP (los aranceles e impuestos se pagan en la entrega, o si aplica un esquema de remisión, se remiten mediante un ID fiscal).
  • Si utiliza nuestra garantía de Landed Cost, este valor siempre debe ser DDP_PREFERRED, que proporcionará una cotización DDP cuando sea posible y una cotización DAP cuando no se permita una DDP. Usar DAP en su lugar puede hacer que los Landed Cost ya no estén garantizados, ya que esto normalmente resulta en aranceles e impuestos pagados en la entrega.
• endUse: Indica si las mercancías se venden a otro negocio (FOR_RESALE) o para uso final con un consumidor (NOT_FOR_RESALE).
• tariffRate: Indica el método que Zonos debe usar para calcular las tasas arancelarias de esta cotización, en caso de que haya un rango de tasas arancelarias que puedan aplicarse. *Al utilizar nuestra garantía de Landed Cost, esto siempre debe ser ZONOS_PREFERRED.

Zonos recomienda encarecidamente usar códigos HS específicos del producto, ya que conduce a una cotización de Landed Cost más precisa. Si conoce sus códigos HS, pase el hsCode de cada item durante itemCreateWorkflow.

Si pasa un código HS, Zonos lo validará al vuelo al obtener una cotización de Landed Cost. Si el código HS que proporcionó no es válido (es decir, no existe), Zonos reclasificará su artículo al vuelo y usará el nuevo código HS válido en lugar del que proporcionó.

Si necesita ayuda para generar códigos HS para sus productos, conozca Zonos Classify y cómo solicitar una clasificación.

Si no pasa a Zonos un hsCode, primero verificaremos Zonos Catalog para ver si tiene un código HS almacenado para su artículo. Si no, llamaremos a Classify para generar una clasificación que respalde su cálculo de Landed Cost según los siguientes campos de detalle del producto de itemCreateWorkflow: description, category y material. Si los campos de detalle de su producto no son lo suficientemente detallados para generar una clasificación según la puntuación de confianza de Classify, se utilizará el código HS predeterminado asignado a su tienda.

Para que Zonos calcule los costos de envío, use shipmentRatingCalculateWorkflow. Las opciones de envío devueltas en la respuesta de envío calculado se correlacionarán con los serviceLevels que haya asignado a los perfiles de envío en Dashboard.

Solución de problemas: Si espera un serviceLevel en la respuesta pero no aparece, asegúrese de que el serviceLevel esté habilitado y sea compatible con el method que seleccionó.

Agregue cartonizeWorkflow (que no tiene entradas) si desea que Zonos ordene sus artículos en cartones antes de encontrar el costo de envío (utilizado para peso dimensional).

Si conoce el serviceLevel y el amount de un envío, puede pasarlos en la porción shipmentRatingCreateWorkflow de la solicitud. Usaremos esos valores para calcular las tasas de transportista asociadas y devolverlas en la respuesta.