Esta API le permite crear un Envío abierto y agregar paquetes al envío durante un periodo de tiempo en lugar de ingresar toda la información de los paquetes y el envío a la vez. El envío permanece abierto por un periodo de cinco días, y permite la adición de paquetes y modificaciones durante ese tiempo. Una vez que se confirme el envío, se puede generar la documentación del envío, como etiquetas, guía aérea o informes. Al final del quinto día, se debe confirmar el envío o este se eliminará.

Nota: los Envíos abiertos se eliminarán si no se confirman al finalizar el quinto día contado a partir de la creación del envío.

La API de Envío abierto se utiliza cuando desee agregar varios paquetes a un envío durante un periodo y no esté seguro de la cantidad de paquetes que planea agregar o cuándo completará el envío. Esto le brinda una forma flexible de preparar su envío durante el día hasta que esté listo para enviarlo.

Los envíos de Envío abierto son con frecuencia envíos de piezas múltiples, pero también pueden ser envíos que contienen paquetes únicos, conocidos como envíos de pieza única.

Para enviar un envío de piezas múltiples (MPS) a un único destinatario, utilice Envío abierto a fin de agregar paquetes individuales al envío o agregue paquetes múltiples si van dirigidos al mismo destinatario.

A continuación encontrará los servicios asociados con el Envío abierto:

• FedEx Express^® dentro de EE. UU. y dentro de Canadá
• FedEx Ground^® dentro de EE. UU. y dentro de Canadá
• FedEx Home Delivery^®
• FedEx International Priority^®
• FedEx International Priority^® Express (IPE)
• FedEx International Economy^®
• FedEx Priority Overnight^TM
• FedEx® Regional Economy
• FedEx® Regional Economy Freight
• FedEx International Connect Plus®
• FedEx® First
• FedEx Priority Express
• FedEx Priority
• FedEx Priority Express Freight
• FedEx Priority Freight
• FedEx Economy (Solo Reino Unido)

A continuación encontrará las funciones asociadas con la API de Envío abierto:

Gestionar Envíos abiertos

Esta función permite a los remitentes crear, modificar y eliminar Envíos abiertos, y puede recuperar Envíos abiertos ya creados para su revisión o verificación. Le permite confirmar el envío completado para transferir información del envío a FedEx y generar la documentación apropiada del envío. También identifica e informa los errores que encuentre en la transacción y proporciona el estado adecuado.

La información clave de esta función es accountNumber, Shipment Data, groupPackageCount, index para señalar el paquete principal del envío. El resultado de esta función garantizará que los datos del envío se carguen en los sistemas de FedEx y que se generen los números de rastreo, etiquetas e informes adecuados.

Gestionar paquetes de Envío abierto

Esta función le permite agregar, modificar y eliminar paquetes en un Envío abierto ya creado. También se puede recuperar un paquete existente para un Envío abierto existente.

Obtener los resultados de Envío abierto (asincrónico)

Esta función permite recuperar los resultados de envíos confirmados de manera asincrónica. Cuando un Envío abierto con 40 paquetes o más se confirma, la API procesa el envío de manera asincrónica.

Cuando el envío se procesa de manera asincrónica, la respuesta a esta solicitud solo confirma que la solicitud se puso en espera con éxito, aunque es posible que el envío no se haya procesado con éxito. Como respuesta, devuelve jobld para recuperar el resultado después. Esta función utiliza jobld para recuperar los resultados de Envío Abierto (CREAR, MODIFICAR Y CONFIRMAR), que pueden ser etiquetas de envío y reportes de envío. También identifica e informa los errores que encuentre en el envío y proporciona el estado adecuado.

Nota: si hay errores en la respuesta de envío asincrónico, corrija los errores y presente una nueva solicitud de envío.

Esta sección describe a detalle el flujo de trabajo de la API de Envío abierto. El flujo de trabajo de Envío abierto se gestiona en dos vías utilizando dos opciones de procesamiento:

Flujo de trabajo para 40 paquetes o menos

1. Utilice el extremo Crear Envío abierto para crear un Envío abierto con toda la información de envío y embalaje requerida, accountNumber e index.
2. Utilice el extremo Agregar paquetes al Envío abierto para agregar uno o más (no más de 40) paquetes a un Envío abierto ya creado. Las claves de ingreso son index y accountNumber del Envío abierto al que se agregan los paquetes.
3. Utilice el extremo Confirmar Envío abierto para confirmar finalmente que se agregaron todos los paquetes y que el envío está completo. Las claves de ingreso son index y accountNumber del envío que se confirmará.

Este extremo Confirmar Envío abierto es el extremo final en este flujo, que valida el envío y la información del paquete, y genera etiquetas de envío con éxito, así como todos los demás informes del envío. Además, proporciona los detalles de error que se devolvieron durante la validación. Estos errores pueden arreglarse utilizando los extremos Modificar Envío abierto o Modificar paquetes del Envío abierto, y confirmando el envío de nuevo para obtener una solicitud exitosa.

Flujo de trabajo para más de 40 paquetes

1. Utilice el extremo Crear Envío abierto para crear un Envío abierto con toda la información de envío y embalaje requerida, accountNumber e index.
2. Utilice el extremo Agregar paquetes al Envío abierto para agregar uno o más (no más de 40) paquetes a un Envío abierto ya creado. Las claves de ingreso son index y accountNumber del Envío abierto al que se agregarán los paquetes.
3. Utilice el extremo Confirmar Envío abierto para confirmar que todos los paquetes se agreguen y que el envío esté completo. Las claves de ingreso son index y accountNumber del envío que se confirmará. En este caso, dado que los paquetes son más de 40, la API procesa el envío de manera asincrónica y devuelve jobld a fin de utilizarlo después para recuperar los resultados del envío. Si la respuesta tiene errores, entonces, debe arreglarlos utilizando los extremos Modificar Envío abierto o Modificar paquetes del Envío abierto, y confirmar el envío utilizando el extremo Confirmar Envío abierto.
4. Usa el extremo Obtener los resultados del Envío Abierto para recuperar los resultados de Crear, Modificar y Confirmar Envío Abierto como etiquetas y documentación de envío. Las claves de ingreso son jobld y accountNumber para envíos confirmados.

El extremo Obtener los resultados del Envío abierto es el extremo final de este flujo que recupera los resultados del Envío abierto confirmado, como etiquetas y otros informes para los Envíos abiertos confirmados. Si la respuesta devuelve detalles de error, entonces, puede arreglarlos utilizando los extremos Modificar el Envío abierto o Modificar paquetes del Envío abierto, después confirmar el envío utilizando el extremo Confirmar el Envío abierto y, finalmente, utilizar el extremo Obtener los resultados del Envío abierto para recuperar los resultados del Envío abierto confirmado para obtener una solicitud exitosa.

A continuación encontrará las funciones asociadas con la API Envío abierto:

Crear Envío abierto

Utilice este extremo para crear un Envío abierto con la información de envío requerida y al menos defina un paquete en el envío.

A continuación se muestra la información de entrada requerida para crear un Envío abierto:

• openShipmentAction: esta es la acción de Envío abierto y, en este caso, utilice el valor como CREATE_PACKAGE.
• accountNumber: este es el número de cuenta FedEx.
• requestedShipment: los detalles del envío del Envío abierto.
• index: es el valor único del Envío abierto; este valor es útil para modificar el envío o el paquete. Es opcional, si no se proporciona; el número de rastreo principal puede utilizarse para identificar de forma única el envío.

La respuesta exitosa a esta solicitud procesará el envío y generará el número de rastreo, que es el número de rastreo principal para el primer paquete. Tenga en cuenta que en la respuesta no se generarán etiquetas.

Agregar paquetes al Envío abierto

Utilice este extremo para agregar uno o más paquetes a la solicitud de Envío abierto existente antes de confirmar el envío. Puede enviar una solicitud separada de Agregar paquete para cada uno de los paquetes cuando prepare su envío a lo largo del día. También puede enviar piezas múltiples dentro de la solicitud de Agregar paquete.

Nota: el número total de paquetes para el envío no debe exceder el límite de paquetes del Envío abierto.

A continuación se muestra la información de entrada requerida para Agregar paquetes a un Envío abierto:

• index: este es un valor único asignado a un Envío abierto ya creado. Si este no está disponible, entonces proporcione el número de rastreo principal.
• requestedPackageLineItem: información detallada de los paquetes que se agregará.
• accountNumber: este es el número de cuenta FedEx.

La respuesta exitosa para esta solicitud generará un número de rastreo para el paquete recién agregado.

Modificar paquetes del Envío abierto

Utilice este extremo para modificar los detalles de uno o más paquetes de un Envío abierto existente antes de confirmar el envío. Esto incluye también el paquete principal, que es el primer paquete agregado al Envío abierto.

A continuación se muestra la información de entrada requerida asociada a esta solicitud:

• index: este es un valor único asignado a un Envío abierto ya creado. Si este no está disponible, entonces proporcione el número de rastreo principal.
• accountNumber: este es el número de cuenta FedEx.
• trackingId: una o más ID de rastreo de los paquetes que forman parte de un Envío abierto que se modificarán.
• requestedPackageLineItem: información detallada de los paquetes que se modificará.

La solicitud exitosa actualizará los paquetes deseados y devolverá los detalles de envío actualizados.

Eliminar paquetes del Envío abierto

Utilice este extremo para eliminar uno o más paquetes de un Envío abierto ya creado antes de confirmar el envío.

A continuación se muestra la información de entrada requerida asociada a esta solicitud:

• index: este es un valor único asignado a un Envío abierto ya creado. Si este no está disponible, entonces proporcione el número de rastreo principal.
• accountNumber: este es el número de cuenta FedEx.
• trackingId: una o más ID de rastreo de los paquetes de Envío abierto para los que se recibe la solicitud de eliminación.

La solicitud exitosa eliminará los paquetes deseados y devolverá el estado del elemento deletedPackagesFromOpenshipment como true en la salida.

Nota: si elimina el paquete principal del envío, el siguiente paquete en la secuencia se convierte en el paquete principal y el número de rastreo principal se reasigna a ese paquete, y la secuencia de números disminuirá, según la cantidad de paquetes que se eliminen.

Recuperar un paquete de un Envío abierto

Utilice este extremo para recuperar uno o más paquetes de un Envío abierto ya creado para revisar o verificar.

A continuación se muestra la información de entrada requerida asociada a esta solicitud:

• index: este es un valor único asignado a un Envío abierto ya creado. Si este no está disponible, entonces proporcione el número de rastreo principal.
• accountNumber: este es el número de cuenta FedEx.
• trackingId: una o más ID de rastreo de los paquetes de Envío abierto para los que se recuperarán los detalles.

La solicitud exitosa recuperará los paquetes deseados.

Modificar Envío abierto

Utilice este extremo para modificar una solicitud de Envío abierto con la información requerida del envío antes de confirmar el envío.

A continuación se muestra la información de entrada requerida asociada a esta solicitud:

• index: este es un valor único asignado a un Envío abierto ya creado. Si este no está disponible, entonces proporcione el número de rastreo principal.
• accountNumber: este es el número de cuenta FedEx.
• requestedShipment: los detalles del envío del para los que se modificará el Envío abierto.

La solicitud exitosa actualizará los detalles del envío del Envío abierto ya creado, y devolverá el número de rastreo para los paquetes modificados y actualizará los detalles de transacción del envío como una salida.

Recuperar un Envío abierto

Utilice este extremo a fin de recuperar un Envío abierto ya creado para revisar o verificar.

A continuación se muestra la información de entrada requerida asociada a esta solicitud:

• index: este es un valor único asignado a un Envío abierto ya creado. Si este no está disponible, entonces proporcione el número de rastreo principal.
• accountNumber: este es el número de cuenta FedEx.

La solicitud exitosa recuperará los detalles del Envío abierto deseado.

Eliminar un Envío abierto

Utilice este extremo para eliminar una solicitud de Envío abierto antes de confirmar el envío.

A continuación se muestra la información de entrada requerida asociada a esta solicitud:

• index: este es un valor único asignado a un Envío abierto ya creado. Si este no está disponible, entonces proporcione el número de rastreo principal.
• accountNumber: este es el número de cuenta FedEx.

La solicitud exitosa eliminará el Envío abierto y todos los paquetes asociados volverán al estado de elemento deletedOpenshipment como true en la salida.

Confirmar un Envío abierto

Utilice este extremo para validar y cargar la información de envío de un Envío abierto en los sistemas de FedEx una vez haya agregado todos los paquetes en la solicitud de envío.

A continuación se muestra la información de entrada requerida asociada a esta solicitud:

• index: este es un valor único asignado a un Envío abierto ya creado. Si este no está disponible, entonces proporcione el número de rastreo principal.
• accountNumber: este es el número de cuenta FedEx.
• labelResponseOptions: especifique si la respuesta debe devolver el bytecode codificado o el URL de la etiqueta.
  Nota: el elemento «labelResponseOptions» solo está disponible en la solicitud de confirmar envío abierto y se generan las etiquetas de confirmación posterior del envío.

La respuesta de confirmación exitosa para 40 paquetes o menos cargará la información del envío en los sistemas de FedEx y generará las etiquetas de los paquetes y todos los demás informes del envío.

La respuesta de confirmación exitosa para más de 40 paquetes confirma que la solicitud está en espera con éxito y devuelve jobld para recuperar el resultado más tarde.

Nota: debe incluirse un mínimo de un paquete en el envío abierto antes de que puedas confirmar el envío.

Obtener los resultados del Envío abierto

Utilice este extremo para obtener información confirmada del Envío abierto. Este extremo solo debe utilizarse cuando el envío tiene más de 40 paquetes y se devolverá jobld en la confirmación del Envío abierto.

A continuación se muestra la información de entrada requerida asociada a esta solicitud:

• resultMethodType: especifique el valor como CREATE.
• accountNumber: este es el número de cuenta FedEx.
• jobld: esta es la jobld que se recibió durante la confirmación del Envío abierto.

La respuesta exitosa a esta solicitud devolverá los resultados del Envío abierto confirmado como etiquetas de los paquetes y todos los demás informes de envío del Envío abierto confirmado. Si la respuesta devuelve detalles de error, entonces puede arreglarlos utilizando los extremos Modificar Envío abierto o Modificar paquetes del Envío abierto, después confirmar el envío utilizando el extremo Confirmar Envío abierto y, finalmente, utilizar el extremo Obtener los resultados del Envío abierto para recuperar los resultados del Envío abierto confirmado para obtener una solicitud exitosa.

Un Envío abierto de piezas múltiples (MPS) consiste en dos o más paquetes enviados a la misma dirección de destino. El primer paquete en la solicitud de envío se considera el paquete principal.

Para crear un envío de varias piezas:

• Incluya la información de nivel de envío, como serviceType, packagingType, totalWeight, totalPackageCount y detalles como requestedPackageLineItems para el paquete principal.
  Nota: el sequenceNumber para el paquete principal debe ser igual a 1.
• Agregue todos los paquetes al envío.
• Confirme el envío.

Después de la confirmación del envío, se utiliza una de las siguientes opciones de procesamiento:

Proceso sincrónico de envío

El procesamiento sincrónico es uno de los métodos de procesamiento ideales que se usa internamente cuando un envío tiene 40 paquetes o menos (conteo total de paquetes/groupPackagecount<=40) con mercancías limitadas en el envío.

Cuando se confirme, la solicitud de envío con 40 paquetes o menos se procesará de forma sincrónica, y las etiquetas, los documentos e informes del envío se generarán de manera instantánea. El proceso es ideal para los remitentes si tienen una restricción de tiempo y deben imprimir las etiquetas inmediatamente después de recibir la confirmación del envío.

Nota: el límite máximo de 40 paquetes es indicativo y no es un límite fijo. El límite también depende de la combinación de paquetes y mercancías en el envío. Para obtener más información, comuníquese con su equipo de Soporte de FedEx.

Ejemplo: su solicitud de Envío abierto consta de 10 paquetes. Cuando usted confirme el envío después de agregar los 10 paquetes, el envío se procesará de manera sincrónica. En la respuesta se crearán 10 etiquetas y se proporcionarán etiquetas de URL o etiquetas codificadas, según lo solicitado.

El siguiente flujo de trabajo de alto nivel demuestra el procesamiento de Envío abierto sincrónico:

1. Utilice el extremo Crear Envío abierto.
2. Agregue de 1 a 40 paquetes utilizando el extremo Agregar paquetes al Envío abierto.
3. Utilice el extremo Confirmar Envío abierto para confirmar el Envío abierto.
4. Una solicitud exitosa debe generar las etiquetas y la respuesta de salida tendrá las etiquetas de URL o etiquetas codificadas, según lo solicitado.
5. Si el envío tiene errores, los detalles de los errores se mostrarán en la respuesta.
6. Después de corregir todos los errores, utilice el extremo Confirmar Envío abierto para obtener una respuesta exitosa.

Nota: 

• En este método, si necesitas agregar más paquetes a un envío existente, solo puedes agregar hasta un total de 40 paquetes. 

Procesamiento asincrónico de envíos

La API procesa el envío internamente de manera asincrónica cuando el número total de paquetes excede 40. (p.ej., totalPackageCount>40). Este es un método muy conveniente cuando el volumen de paquetes es grande y desea enviar los envíos en lote periódicamente. Este envío en lote usa varios recursos y operaciones de FedEx que son costosos cuando se envían a la vez. Con esta opción de procesamiento, FedEx garantiza internamente que estos envíos en lote se procesen y usted puede obtener los datos de las etiquetas de forma periódica.

Cuando el envío se procesa de manera asincrónica, la respuesta a esta solicitud solo confirma que la solicitud se puso en espera con éxito, aunque es posible que el envío no haya sido procesado con éxito y devuelve jobld para recuperar el resultado después.

Nota: este proceso requiere algo de tiempo para que el envío se procese con éxito antes de recuperar el resultado.

Para recuperar el resultado asincrónico del envío, utilice el extremo Obtener los resultados del Envío abierto y proporcione los detalles de jobld y accountNumber en la solicitud. La respuesta a esta solicitud devolverá los datos de resultado del envío con detalles de la etiqueta o detalles de error del envío.

Ejemplo: su envío consta de 45 paquetes y, cuando se confirme, se procesará asincrónicamente. En la respuesta, se devolverá una jobld. Entonces, deberá utilizar el extremo Obtener los resultados del Envío abierto para recuperar los resultados del envío y los datos de la etiqueta.

El siguiente flujo de trabajo de alto nivel demuestra el procesamiento del envío asincrónico:

1. Utilice el extremo Crear Envío abierto.
2. Agregue 40 paquetes o más utilizando el extremo Agregar paquetes al Envío abierto.
3. Utilice el extremo Confirmar Envío abierto para confirmar el envío.
4. El envío exitoso proporcionará una jobId.
5. Utilice jobId y accountNumber para recuperar los resultados de salida utilizando el extremo Obtener los resultados del Envío abierto.
6. La salida exitosa proporcionará los datos de resultado del envío con los detalles de la etiqueta.
7. Si el resultado tiene errores, los detalles de los errores se mostrarán en la respuesta.

Nota:

• En este método, para una única solicitud el máximo total de paquetes permitidos es de 300.o hasta 999 mercancías. 
• En este método, una vez que se envía la solicitud, no puedes agregar un nuevo paquete ni modificar o borrar los paquetes de la solicitud original. Si existen errores en la respuesta, arregla los errores utilizando el extremo Modificar paquetes del envío abierto, y luego confirma el envío usando Confirmar un envío abierto y obtén los resultados de salida con éxito utilizando el extremo Obtener los resultados del envío abierto.

La API de FedEx admite una gran variedad de etiquetas. La API de FedEx admite tres tipos de opciones de etiqueta, incluidas las térmicas, de papel normal y etiquetas personalizables. Puede utilizar los extremos de la API de Envío abierto para producir una amplia variedad de etiquetas.

FedEx ofrece 2 formatos de etiqueta para los servicios de envío:

• Etiquetas térmicas
• Etiquetas láser

Etiquetas térmicas

La API FedEx le permite imprimir etiquetas de envío para todos los tipos de envío, como FedEx Express^®, FedEx Ground^® y FedEx International Ground^® utilizando una variedad de impresoras de etiquetas térmicas.

La API de FedEx admite los siguientes tamaños de etiquetas térmicas:

• 10,16 cm x 15,24 cm: sin una pestaña de documento configurable (pestaña de documento)
• 10,16 cm x 17,14 cm: con o sin una pestaña de documento
• 10,16 cm x 20,32 cm: proporciona espacio para incluir un archivo gráfico o de texto de su elección
• 10,16 cm x 21,59 cm: con una etiqueta de documento configurable (se incluye específicamente la etiqueta para identificar neumáticos)
• 10,16 cm x 22,86 cm: proporciona espacio para gráficos o texto, así como una pestaña de documento
• 10,16 cm x 26,67 cm: con una etiqueta de documento configurable (se incluye específicamente la etiqueta para identificar neumáticos)

Los tipos de inventario de etiquetas de 10,16 cm x 21,59 cm y 10,16 x 26,67 incluyen una pestaña de documento adicional con un código de barras idéntico. Un código de barras se muestra en la etiqueta principal y el otro en la pestaña de documento. La información del tipo de inventario de etiquetas es útil para los paquetes de neumáticos, ya que puede colocarse en la banda de rodamiento del neumático y la pestaña de documento adicional, con una copia del código de barras e instrucciones operacionales, en el flanco del neumático. Utilizar este tipo de inventario de etiquetas reduce el reetiquetado de neumáticos y el aumento de los escaneos dimensionales optimiza la recuperación. Para obtener más información sobre el inventario de etiquetas, consulta «Tipos de inventario de etiquetas».

Nota: la pestaña de documento es una pestaña de etiqueta removible con información de envío adicional que se puede seleccionar para el inventario de etiquetas mientras se usa una impresora térmica para imprimir las etiquetas de envío.

Elementos de la etiqueta térmica

Las etiquetas térmicas del envío contienen tres elementos básicos:

• Contenido legible para el ser humano: esta parte de la etiqueta contiene la información de envío.
• El código de barras de envío de Ground legible para el ser humano se encriptará en forma predeterminada.
• Código de barras bidimensional (2D): el código de barras dimensional alfanumérico almacena información para los envíos de FedEx Express y FedEx Ground utilizando el estándar MH 10.8.3 del Instituto Nacional de Estándares de los Estados Unidos (ANSI). El código de barras 2D se crea utilizando la simbología 417 del formato de documento portátil (PDF).
• Código de barras específico de FedEx:
  • Asistencia de enrutamiento de rastreo de clasificación avanzada (ASTRA) para los envíos de FedEx Express hasta que el código de barras FDX 1D se sincroniza por completo; código de barras «96» para envíos de FedEx Ground y FedEx Home Delivery. FedEx Ground también permite el uso del código de barras SSCC-18 «00».
  • El código de barras de FedEx 1D (FDX 1D) para los envíos de FedEx Express se crea utilizando ANSI o AIM BC4-1995 (Código de especificación de simbología uniforme-128C).

Información clave para generar la etiqueta térmica

La siguiente es la información clave que se requiere para generar una etiqueta térmica:

• LabelFormatType: se requiere para recibir la imagen de etiqueta correcta en la API de respuesta de Envío abierto:
  • COMMON2D: el tipo de formato de etiqueta para recibir una etiqueta.
  • LABEL_DATA_ONLY: el valor usado para recibir el dato del código de barras si crea una etiqueta personalizada.

Valores válidos:

• ImageType: se requiere para formatear la etiqueta térmica para la impresora que usa; proporciona el tipo de transmisión de datos o mapa de bits que se devuelve.

  • EPL2 – Eltron (tipos de inventario de etiquetas)
  • ZPLII – Zebra (tipos de inventario de etiquetas)

Valores válidos:

Nota: todas las etiquetas necesarias para un envío se generan y devuelven en una interfaz única.

Impresoras térmicas aceptadas

Las siguientes impresoras térmicas se recomiendan para la API FedEx:

• Unimark
• Eltron
  • Orion (EPL2)
  • Eclipse (EPL2)
• Zebra
  • LP2443 (EPL2)
  • LP2844 (EPL2)
  • Gk420 (ZPL)
  • LP2348 Plus (EPL2/ZPL)
  • Z4M Plus (ZPL o EPL)
  • ZP500/ZP505 (EPL2/ZPL)
  • Z4M/Z4M+ (EPL2/ZPL)
  • ZM400 (EPL2/ZPL)
  • ZT410 (EPL2/ZPL)
  • Otras series de impresoras ZT4xx (EPL2/ZPL)

Nota: estas impresoras son todas compatibles con el modo de página del Lenguaje de programación de Eltron ASCII (EPL2). Las impresoras térmicas son compatibles para escritura directa con la impresora conectada a un puerto de serie del sistema y como una impresora nativa de Windows instalada para conexiones LPT, serial o USB. Las versiones de firmware de las impresoras de FedEx proporcionadas pueden variar según la región.

Número de etiquetas térmicas impresas por servicio

La siguiente tabla indica el número de cada tipo de etiqueta necesaria para un servicio especial específico. Todas las etiquetas necesarias se generan con una llamada al Servidor de etiqueta común (CLS) de FedEx y el CLS devuelve un búfer simple con la excepción de las etiquetas de devolución del COD.

Número de etiquetas térmicas impresas por el servicio de EE. UU.

Tipo de servicio	Etiquetas térmicas (el CLS de FedEx devolverá el número apropiado de etiquetas en la respuesta)
FedEx Express EE. UU.	1 etiqueta de envío
FedEx Ground EE. UU./FedEx Home Delivery	1 etiqueta de envío

Número de etiquetas térmicas impresas por el servicio de exportación internacional de EE. UU.

Tipo de servicio	Etiquetas térmicas (el CLS de FedEx devolverá el número apropiado de etiquetas en la respuesta)
FedEx Express U.S. Export International	1 etiqueta de envío 2 etiquetas de destinatario
Opc. selec. de agente aduanal de FedEx Express U.S. Export International	1 etiqueta de envío 2 etiquetas de destinatario
FedEx Ground U.S. Export International	1 etiqueta de envío
COD de FedEx Ground U.S. Export International	1 etiqueta de envío 2 etiquetas de devolución de COD

Número de etiquetas térmicas impresas por el servicio dentro de Canadá

Tipo de servicio	Etiquetas térmicas (el CLS de FedEx devolverá el número apropiado de etiquetas en la respuesta)
FedEx Express dentro de Canadá	Envío sin mercancías peligrosas (DG)/hielo seco: 1 etiqueta de envío
FedEx Ground dentro de Canadá	1 etiqueta de envío
COD de FedEx Ground dentro de Canadá	1 etiqueta de envío 2 etiquetas de devolución de COD

Número de etiquetas térmicas impresas por el servicio de exportación internacional de Canadá

Tipo de servicio	Etiquetas térmicas (el CLS de FedEx devolverá el número apropiado de etiquetas en la respuesta)
FedEx Express Canada Export International	Envío sin DG/hielo seco: 1 etiqueta de envío 2 etiquetas de destinatario
FedEx Express Canada Export International Broker Select	Envío sin DG/hielo seco: 1 etiqueta de envío 2 etiquetas de destinatario
FedEx Ground Canada (CA) Export International	1 etiqueta de envío

Número de etiquetas térmicas impresas por los envíos de entrada de Filipinas y Tailandia

Tipo de servicio	Etiquetas térmicas (el CLS de FedEx devolverá el número apropiado de etiquetas en la respuesta)
Envíos de entrada de Filipinas	2 etiquetas de envío con número de cuenta impreso 1 etiqueta de destinatario sin el número de cuenta impreso 3 copias del recibo comercial
Envíos entrantes de mercancía de Tailandia	3 etiquetas de envío con número de cuenta impreso 1 etiqueta de destinatario sin el número de cuenta impreso
Envíos de documentos entrantes de Tailandia	2 etiquetas de envío con número de cuenta impreso 1 etiqueta de destinatario sin el número de cuenta impreso

Pestañas de documento

Si usted imprime etiquetas de envío utilizando una impresora térmica, puede elegir una variedad de etiquetas que incluye una pestaña de documento, una pestaña extraíble adhesiva con información del envío adicional. Puede configurar esta información del envío desde sus datos de envío o elegir imprimir datos configurables que son específicos para las necesidades de su envío.

Etiquetas láser

La API de FedEx admite la impresión de etiquetas con una impresora láser. Estas etiquetas se imprimen en general en tamaño carta o A4 de EE. UU. y se doblan por la mitad para adaptarse a la bolsa de la etiqueta estándar de FedEx. Las etiquetas impresas con una impresora láser se generan en formato PDF y no es necesario cambiar su tamaño o su escala. Para obtener más información sobre el inventario de etiquetas, consulte Tipos de inventario de etiquetas.

Requisitos previos

Los siguientes requisitos aplican a las etiquetas en PDF:

• Se requiere Adobe Reader 6.0 o superior para procesar la etiqueta.
• Los controladores de la impresora deben tener configurado el escalado de página en «ninguno».
• No es necesario usar un envoltorio HTML para mostrar una etiqueta PDF en papel normal en un navegador.
• Acrobat recomienda los siguientes navegadores para ver documentos PDF:
  • Microsoft® Internet Explorer 10 o superior
  • Firefox 1.0 o superior
  • Mozilla 1.7 o superior

La opción de etiqueta en PDF elimina la necesidad de especificar el parámetro de la orientación de la imagen (ancho y altura) o la resolución de la pantalla para mostrar la etiqueta de forma apropiada en el navegador.

Elementos de la etiqueta láser

Las etiquetas de envío láser contienen tres elementos básicos:

• Contenido legible para el ser humano: esta parte de la etiqueta contiene la información del envío.
• El código de barras de envío de Ground legible para el ser humano se encriptará en forma predeterminada.
• Código de barras bidimensional (2D): el código de barras dimensional alfanumérico almacena información para los envíos de FedEx Express y FedEx Ground utilizando el estándar MH 10.8.3 del Instituto Nacional de Estándares de los Estados Unidos (ANSI). El código de barras bidimensional (2D) se crea con el formato 417 de archivo de datos portátil (PDF).
• Código de barras específico de FedEx:
  • Asistencia de enrutamiento de rastreo de clasificación avanzada (ASTRA) para los envíos de FedEx Express hasta que el código de barras FDX 1D se sincroniza por completo; código de barras «96» para envíos de FedEx Ground y FedEx Home Delivery. FedEx Ground también permite el uso del código de barras SSCC-18 «00» cuando corresponde.
  • El código de barras de FedEx 1D (FDX 1D) para los envíos de FedEx Express se crea utilizando ANSI o AIM BC4-1995 (Código de especificación de simbología uniforme-128C).

Información clave para generar una etiqueta láser

Se necesitan los siguientes elementos de la API de FedEx para generar una etiqueta láser:

• LabelSpecification/LabelFormatType: se requiere para recibir la imagen de etiqueta correcta en la API de respuesta de Envío abierto: los valores válidos son:
  • COMMON2D: el tipo de formato de etiqueta para recibir una etiqueta.
  • LABEL_DATA_ONLY: el valor usado para recibir el dato del código de barras si crea una etiqueta personalizada.

• LabelSpecification/ImageType: se requiere para indicar el formato de la etiqueta. Tipo de secuencia de datos o mapa de bits a devolver:

  Los valores válidos son:

  • PDF: papel normal
  • PNG: papel normal

• LabelSpecification/LabelStockType: se requiere para todos los tipos de etiquetas. Especifique si el inventario de etiquetas tiene pestañas de documento en el extremo anterior o posterior de las etiquetas o si no tiene pestañas de documento. Cuando usa un ImageType (tipo de imagen) de PDF o PNG, estos valores muestran una etiqueta de formato láser:
  • PAPER_4X6
  • PAPER_4X8
  • PAPER_4X9
  • PAPER_4X675
    Estos valores muestran una etiqueta de envío de papel normal:
  • PAPER_7X47
  • PAPER_85X11_BOTTOM_HALF_LABEL
  • PAPER_85X11_TOP_HALF_LABEL
  • PAPER_LETTER

Nota: si solicita una etiqueta de papel normal, los datos devueltos son una imagen de etiqueta codificada en Base64, que debe decodificarse en Base64 antes de mostrar el archivo de la etiqueta.

Impresoras láser compatibles

La mayoría de las impresoras láser son compatibles para este tipo de etiquetas; sin embargo, las etiquetas no se aceptarán si están impresas en una impresora de chorro de tinta.
Nota: si usa una impresora láser a color, la definición del color debe establecerse en negro, incluso si la impresora solo tiene un cartucho negro instalado.

Número de etiquetas láser necesarias por servicio

La siguiente tabla indica el número de cada tipo de etiqueta necesaria para un servicio especial específico. Todas las etiquetas necesarias se generan con una llamada al Servidor de etiqueta común (CLS) de FedEx y el CLS devuelve un búfer simple con la excepción de las etiquetas de devolución del COD.

Número de etiquetas láser impresas por el servicio de EE. UU.

Tipo de servicio	Etiqueta láser: Formato PDF
FedEx Ground/FedEx Home Delivery EE. UU.	1 etiqueta de envío

Número de etiquetas láser impresas por el servicio de exportación internacional de EE. UU.

Tipo de servicio	Etiqueta láser: Formato PDF
FedEx Express U.S. Export International	1 etiqueta de envío en la respuesta; un mínimo de 3 etiquetas se debe imprimir: 1 etiqueta sobre el paquete y 2 en la bolsa del documento.
FedEx Express U.S. Export International Broker Select	1 etiqueta de envío en la respuesta; un mínimo de 3 etiquetas se debe imprimir: 1 etiqueta sobre el paquete y 2 en la bolsa del documento.
FedEx Ground U.S. Export International	1 etiqueta de envío
COD de FedEx Ground U.S. Export International	1 etiqueta de envío 2 etiquetas de devolución de COD

Número de etiquetas láser impresas por el servicio dentro de México

Tipo de servicio	Etiqueta láser: Formato PDF
FedEx Express dentro de México	FedEx Express dentro de México Envío sin mercancías peligrosas (DG)/hielo seco: 1 etiqueta de envío

Número de etiquetas láser impresas por el servicio dentro de Canadá

Tipo de servicio	Etiqueta láser: Formato PDF
FedEx Express dentro de Canadá	FedEx Express dentro de Canadá Envío sin mercancías peligrosas (DG)/hielo seco: 1 etiqueta de envío
FedEx Ground dentro de Canadá	1 etiqueta de envío
COD de FedEx Ground dentro de Canadá	1 etiqueta de envío 2 etiquetas de devolución de COD

Número de etiquetas láser impresas por el servicio de exportación internacional de Canadá

Tipo de servicio	Etiqueta láser: Formato PDF
FedEx Express Canada Export International	FedEx Express Canada Export International Envío sin DG/hielo seco: 1 etiqueta de envío 2 etiquetas de destinatario
FedEx Express Canada Export International Broker Select	FedEx Express Canada Export International Broker Select Envío sin DG/hielo seco: 1 etiqueta de envío 2 etiquetas de destinatario
FedEx Ground Canada (CA) Export International	1 etiqueta de envío

Número de etiquetas láser impresas por el servicio de exportación internacional de Canadá

Tipo de servicio	Etiqueta láser: Formato PDF
FedEx Express Canada Export International	FedEx Express Canada Export International Envío sin DG/hielo seco: 1 etiqueta de envío 2 etiquetas de destinatario
FedEx Express Canada Export International Broker Select	FedEx Express Canada Export International Broker Select Envío sin DG/hielo seco: 1 etiqueta de envío 2 etiquetas de destinatario
FedEx Ground Canada (CA) Export International	1 etiqueta de envío

Número de etiquetas láser impresas por los envíos de entrada de Filipinas y Tailandia

Tipo de servicio	Etiquetas térmicas (el CLS de FedEx devolverá el número apropiado de etiquetas en la respuesta)
Envíos de entrada de Filipinas	2 etiquetas de envío con número de cuenta impreso 1 etiqueta de destinatario sin el número de cuenta impreso 3 copias del recibo comercial
Envíos entrantes de mercancía de Tailandia	3 etiquetas de envío con número de cuenta impreso 1 etiqueta de destinatario sin el número de cuenta impreso
Envíos de documentos entrantes de Tailandia	2 etiquetas de envío con número de cuenta impreso 1 etiqueta de destinatario sin el número de cuenta impreso

Etiqueta de aduana

FedEx permite la personalización de la etiqueta generada por FedEx. Puede agregar texto pertinente a su negocio y elegir el tipo de código de barras (simbología) utilizado en los documentos y etiquetas de FedEx en la parte personalizada de las etiquetas térmicas.

Para dar soporte a su aplicación de envío, la API de Envío abierto de FedEx proporciona dos opciones para personalizar su etiqueta de envío:

• Ubique el gráfico PNG en papel de 18 cm x 12 cm sobre su rollo de etiqueta. Por ejemplo, puede crear una lista de embalaje en un formulario de 22 cm x 28 cm. Como parte de este formulario, también puede ubicar el gráfico PNG en papel de 18 cm x 12 cm en vez de crear una etiqueta personalizada usted mismo.
• Agregue un gráfico o archivo de texto a la etiqueta térmica de 10 cm x 20 cm o 10 cm x 23 cm. Este tamaño de etiqueta proporciona 5 cm de espacio para su gráfico o texto.

Nota: el contenido legible para el ser humano de la etiqueta y el código de barras en la parte común de la etiqueta no pueden alterarse.

Etiqueta de validación personalizada

Puede crear etiquetas personalizadas que no son para envíos a nivel del paquete y del envío especificando qué información personalizada se precisa, cómo formatear esa información y dónde ubicarla en la etiqueta personalizada. Las etiquetas personalizadas están limitadas al formato de etiqueta térmica.

Personalice una etiqueta térmica

La API de FedEx proporciona dos formatos de etiquetas térmicas que usted puede personalizar con un gráfico o archivo de texto para evitar la necesidad de crear una etiqueta personalizada. Estas etiquetas admiten todos los servicios de envío de FedEx. Estos formatos son:

• Etiqueta térmica de 10 cm x 20 cm sin pestañas de documento
• Etiqueta térmica de 10 cm x 23 cm con pestañas de documento

Estos tipos de etiquetas proporcionan una sección personalizable de 5 cm. Esta característica es aplicable a la etiqueta térmica impresa en una impresora térmica establecida en 203 DPI o 300 DPI.

Reglas de etiquetas personalizadas

Las reglas para usar los formatos de etiquetas son:

• Solo se puede personalizar la etiqueta de envío. Por ejemplo, si imprime una etiqueta de envío Express de 10 cm x 20 cm con su logotipo, las etiquetas del destinatario secundario no lo mostrarán.
• El gráfico o texto personalizable no puede exceder los 5 cm de alto y 11 cm de ancho.
• FedEx no proporciona ninguna corrección. El gráfico o texto se imprime como se presenta en el servicio de envío.
• Si no se proporcionan todos los datos necesarios para imprimir el gráfico o texto (por ejemplo: coordenadas X o Y), la etiqueta de envío válida se devuelve sin los datos personalizados. Debe cancelar el envío representado por esta etiqueta si intenta recrear otra etiqueta con el gráfico o el texto.
• Considerando la ubicación de las coordenadas X o Y, la coordenada de referencia del punto de inserción es la intersección de los bordes superior e izquierdo de la etiqueta térmica de 10 cm x 17 cm con la pestaña de documento inferior. Para las etiquetas térmicas de 10 cm x 17 cm con pestaña de documento, incremente los valores de la coordenada del punto de inserción Y en 164 puntos. Para las etiquetas de 10 cm x 15 cm sin pestaña de documento, incremente los valores de la coordenada del punto de inserción Y en 8 puntos. Los atributos del elemento de la etiqueta térmica están basados en una resolución de impresora de 203 DPI (8 puntos por mm).
• El punto de inserción de caracteres es la esquina superior izquierda del primer carácter de la cadena, en la línea límite.
• Las restricciones de la impresora requieren que la posición se origine en el cuadrante superior izquierdo del frente. Por lo tanto, es posible que los datos se inicien en la sección personalizable de la etiqueta y se escriban en la porción de FedEx de la etiqueta (datos de etiqueta térmica real). Si esto ocurre, la información de la etiqueta de FedEx quedará superpuesta a su logotipo o texto. Debe corregir esta posición para utilizar la etiqueta de envío.
• La adición de la información de la pestaña de documento a la etiqueta de 10 cm x 23 cm debe configurarse utilizando el mismo proceso que usaría para una etiqueta térmica de pestaña de documento estándar de 10 cm x 15 cm.

Nota: solo se deben agregar imágenes en color de un solo bit, ya que las etiquetas se imprimirán en blanco y negro.

Elementos de entradas de gráficos de etiquetas personalizadas

La API ofrece imágenes PNG (gráfico de red portátil) para las etiquetas de FedEx Express y FedEx Ground. El gráfico de etiqueta PNG es una réplica de las etiquetas de papel térmico o normal compatibles con la API. Esta opción de etiqueta le permite colocar el gráfico de etiqueta PNG en su inventario de etiquetas para evitar la necesidad de crear una etiqueta personalizada.

Los siguientes requisitos aplican cuando se utiliza el gráfico PNG de 10 cm x 15 cm incorporado al documento de envío:

• Inventario de etiquetas
• Impresora
• Escalas

Inventario de etiquetas

Las etiquetas PNG de 10 cm x 15 cm solo deben usarse con inventarios de etiquetas adhesivas. Los equipos de certificación de etiquetas de FedEx Ground y FedEx Express rechazarán las etiquetas PNG de 10 cm x 15 cm que no estén en los inventarios de etiquetas adhesivas, incluidas las etiquetas impresas en papel normal.

Impresora

Se recomienda usar impresoras láser para imprimir etiquetas. Las impresoras de inyección de tinta no deben utilizarse por la inconsistencia en la creación de códigos de barras escaneables. Las etiquetas PNG de 10 cm x 15 cm no se pueden imprimir con una impresora a color, a menos que la definición del color esté configurada en negro, incluso si la impresora solo tiene el cartucho de tinta negra instalado. Esta configuración es necesaria para lograr la definición de código de barras correcta a fin de escanear en los centros de distribución de FedEx.

Escalas

La imagen que se devuelve en su transacción de envío es de 200 puntos por pulgada (DPI) y mide 10 cm (ancho) x 15 cm (alto), u 800 x 1200 píxeles. Esta etiqueta tiene una orientación vertical y está diseñada para imprimir etiquetas en un área de 10 cm x 15 cm. Cuando se imprime, la etiqueta debe medir 10 cm x 15 cm.

Para producir la etiqueta y los códigos de barras con el DPI requerido, debe ajustar la escala de la imagen (o cambiar su tamaño) antes de imprimirla. La manera de ajustar la escala de la imagen depende de la aplicación que está utilizando para ver e imprimir la etiqueta. Para ajustar la escala de la imagen PNG para una etiqueta de 10 cm x 15 cm en centímetros: use 10 cm de ancho y 15 cm de largo exactamente.

Lista de verificación de revisión de etiquetas

Todos los códigos de barras

Para la validación se requiere:

• Zona silenciosa: debe tener siempre al menos 0,25 cm de espacio en blanco por encima y por debajo del código de barras.
• Zona silenciosa: Debe tener siempre al menos 0,51 cm de espacio en blanco a la izquierda y a la derecha del código de barras.
• Valide que todos los códigos de barras cumplan los requisitos mínimos de altura.

Calidad de impresión

Problemas comunes que generan el rechazo de las etiquetas:

• Barras de división
• Impresión descolorida/blancos nulos
• Repetición de blancos nulos (problema con los rodillos)
• Manchas (transferencia térmica)
• La descamación (láser) indica un problema de fusión del tóner
• Arrugas en la impresión (transferencia térmica)
• El contraste de impresión para las etiquetas térmicas directas debe ser al menos del 90 %

Detalles legibles para el ser humano para etiquetas de Ground

Para que las etiquetas de FedEx Ground sean legibles para el ser humano, se requieren los siguientes elementos de validación:

• Los datos deben coincidir con el código de barras.
• Logotipo de FedEx Ground: los logotipos están disponibles para su descarga desde el sitio web de FedEx Identity en fedex.com.
• Logotipo de FedEx Home Delivery: las etiquetas deben tener una «H» grande en una casilla a 2,54 cm de la dirección a enviar. La «H» debe ser de al menos 0,63 cm x 1,54 cm.
• Descripción del servicio
• Información del remitente
• Información del destinatario
• Código postal y enrutamiento
• Fecha de envío
• Peso real
• Información del dispositivo de automatización del cliente (medidor, aplicación/sistema, versión)
• Dimensiones
• Información de referencia variada
• Número de rastreo e ID de formulario (el número de rastreo debe tener 14 dígitos)
• ID de la rampa del aeropuerto
• Código postal

Detalles de etiquetas Express legibles para el ser humano

Los siguientes elementos deben estar impresos en la etiqueta para pasar la certificación:

• Logotipo de FedEx Express: los logotipos están disponibles para su descarga desde el sitio web de FedEx Identity en fedex.com.
• Descripción del servicio
• Tipo de paquete, si es internacional
• Día de la semana para la entrega (ejemplo: LUN, para lunes)
• Fecha de entrega estimada
• Número de medidor
• Fecha de envío
• Formato del recuento de piezas, fraseología de la etiqueta principal, fraseología de la etiqueta del CRN en todos los MPS
• ID de la rampa del aeropuerto
• Código postal y enrutamiento
• Prefijo y sufijo del enrutamiento de URSA
• Códigos de manejo
• Compromiso del área de servicio
• Números de teléfono del destinatario y del remitente
• Peso
• Dimensiones, si corresponde
• Campo de referencia si es un envío de alcohol
• Número de rastreo e ID de formulario (el número de rastreo debe tener 14 dígitos)
• En la etiqueta ASTRA, el número de rastreo de 12 dígitos se encuentra en las posiciones 17 a 28 del código de barras de 32 caracteres. En el nuevo código de barras FDX 1D, el número de rastreo ocupa las posiciones 21 a 34. El número de rastreo de FedEx Express continuará siendo de 12 dígitos. Los ceros ocuparán las dos posiciones iniciales.

Las siguientes normas se aplican a la API de Envío abierto:

• El Envío abierto también puede crearse y confirmarse con un paquete.
• Los Envíos abiertos se eliminarán si no se confirman al finalizar el quinto día contado a partir de la creación del envío.
• Una vez que el envío se confirma, no se pueden agregar más paquetes al Envío abierto.