By
·
23 minute read
¿Han conectado FedEx correctamente pero tienen problemas al crear las etiquetas? Así pueden solucionarlos caso por caso:
Cómo solucionar los errores de FedEx en ShippyPro
Para corregir rápidamente sus pedidos/envíos de FedEx y resolver los errores, sigan estos pasos:
Vayan a la sección Orders > Errors de la plataforma ShippyPro. Aquí encontrarán la lista de pedidos que han tenido errores y requieren su atención.
Identifiquen el tipo de error en la columna Error Type y revisen el Error Message para ver los detalles específicos.
Hagan clic en el botón "How to Fix?" junto al mensaje de error para ver una solución sugerida.
Corrijan el error haciendo clic en el icono de la llave inglesa para abrir el formulario del pedido y, a continuación, modifiquen los campos incorrectos o vacíos.
Para más detalles, pueden consultar el siguiente artículo: Orders Errors and How to Fix Them
Si aparece un mensaje antes de generar las etiquetas, pasen el ratón por encima del icono del signo de exclamación y lean el mensaje de error que se muestra.
Errores de FedEx de peso, dimensiones y embalaje
¿Por qué veo el error “Total commodities weight is greater than package or shipment weight”?
Si introducen un peso total y envían fuera de la UE, ShippyPro divide el peso entre el número de artículos y lo redondea. El total no coincide y FedEx muestra un mensaje de error.
Pueden solucionarlo aumentando el peso total manualmente.
¿Por qué veo el error “Packaging type missing or invalid”?
No todas las combinaciones de servicio y tipo de embalaje de FedEx son compatibles: pregunten a FedEx qué embalaje deben usar en combinación con sus servicios.
¿Por qué veo el error “Length, width, and height must be greater than 0 for package 1”?
Si envían desde EE. UU. o Canadá, comprueben que todas las dimensiones indicadas para el bulto sean mayores que 0 al convertirlas a pulgadas (por lo tanto, cada dimensión debe tener un valor mínimo de 3 cm).
¿Por qué veo el error “Package X - Dimensions exceed length and girth limit allowed”?
X se refiere al bulto que causa el error (por ejemplo, si no se acepta el segundo bulto, aparecerá "Package 2").
Este error significa que las dimensiones del bulto no cumplen los límites impuestos por el transportista para ese servicio concreto. Encontrarán más información en las FedEx General Parcel Guidelines en este enlace: https://www.fedex.com/content/dam/fedex/us-united-states/services/GrlPkgGuidelines_fxcom.pdf
¿Por qué veo el error “Weight - weight must be greater than 0 in Commodity…”?
Cuando envíen con FedEx bultos que contengan más de un artículo, presten atención al peso: en la sección Parcels deben añadir el peso total de los bultos, mientras que en los detalles de la sección CN22, en "weight", deben introducir el peso y el precio unitario de cada artículo.
La suma de los pesos de los bultos y la suma de los pesos de los artículos en el CN22 deben coincidir.
¿Por qué veo el error “COMMODITYWEIGHT.GREATERTHAN.PACKAGEWEIGHT - Total commodities weight is greater than the package weight. Please check each commodities weight entered."?
El error aparece si el "peso total" es igual a la suma de los pesos de los productos del envío. FedEx espera que el material de embalaje esté incluido en el campo "peso total".
Prueben a aumentar el valor del campo "peso total" y a volver a procesar el envío.
¿Por qué veo el error “PACKAGE_INDEX - 1 WEIGHT - 68.01 WEIGHT_UNITS - KG WEIGHT.BELOWMINIMUMLIMIT.ERROR - The weight entered is below the standard minimum for FedEx {package} Express services. Please enter a weight of at least 68.01 KG."?
Para utilizar el servicio Freight, el peso indicado debe ser superior a 68 kg por bulto, o las dimensiones del bulto deben corresponder a un peso volumétrico superior a 68 kg.
¿Por qué veo el error "The sum of the weights of items exceeds the total weight of the parcels. Please fix the weights and try again."?
Tengan en cuenta que el peso total del bulto debe ser ligeramente superior a la suma de los valores de los artículos declarados en el CN22, ya que FedEx también tiene en cuenta el peso del embalaje.
¿Por qué veo el error "Package 1 - YOUR_PACKAGING cannot exceed the limit of 68.00 KG."?
Reduzcan el peso total de los bultos y de los artículos individuales si hay un formulario CN22.
"The parcel weight is less than the total weight calculated from all items (unit weight × quantity)"
El sistema ha detectado una incoherencia entre el peso declarado del bulto y el peso total de los artículos (peso unitario × cantidad). Si los artículos pesan más que el bulto, el transportista rechazará el envío.
Verifiquen el peso real del bulto (incluido el embalaje), comprueben la cantidad de artículos y actualicen el pedido en ShippyPro asegurándose de que el peso del bulto sea igual o superior al peso total de los artículos.
Errores de FedEx en la descripción de la mercancía
¿Por qué veo el error “Error: fault”?
Si aparece el mensaje de error "fault" después de crear el envío, significa que hemos recibido la cantidad de un artículo como número decimal (por ejemplo, 1.5) en lugar de como número entero (por ejemplo, 1). Para corregir el error, primero comprueben que la cantidad de artículos sea un número entero y después corrijan el envío.
¿Por qué veo el error “Incomplete commodity description”?
FedEx no acepta descripciones genéricas en el documento CN22.
Una descripción genérica como 'pants' no se aceptará, mientras que 'Jeans Pants' sí.
¿Por qué veo el error “COMMODITY_INDEX - 1 COMMODITY.DESCRIPTION.REQUIRED - A commodity description is required."?
Asegúrense de que cada artículo del pedido tenga un nombre correspondiente importado desde el Marketplace.
Si falta el nombre de algún artículo, añádanlo en el Marketplace y esperen a que el pedido se vuelva a importar con los datos completos.
¿Por qué veo el error "COMMODITY INDEX - 1 CUSTOMS.DESCRIPTION.INCOMPLETE"?
FedEx exige que la información aduanera sea lo más detallada posible en un máximo de 35 caracteres: deben evitarse descripciones como "gift".
No hay un mínimo exigido, pero FedEx puede considerar que la descripción está incompleta si es demasiado genérica.
¿Por qué veo el error "COMMODITY_INDEX - 1 SHIPMENT.COMMODITYDESC.VAGUE.NOTALLOWED - The description for commodity 1 is vague and is not allowed"?
FedEx se ha alineado con la normativa de la Comisión Europea y ahora exige que cada pedido incluya una descripción detallada y específica de la mercancía. Actualicen su pedido con una descripción clara y conforme tanto en los detalles del pedido como en los detalles del CN22.
Si necesitan orientación para completar correctamente la descripción del artículo, pueden consultar:
- la documentación oficial de la Comisión Europea con ejemplos de descripciones no aceptables y sus alternativas correctas;
- el vídeo explicativo de FedEx con consejos prácticos para introducir una descripción conforme;
Si el problema persiste, accedan a su perfil y comprueben si en Preferences > Custom Value la opción está activada. Si es así, pueden actualizar los datos introducidos o seleccionar otra preferencia.
Asegúrense también de no seleccionar Order Numbers y de transmitir una de las otras opciones.
-4.png?width=401&height=290&name=image%20(2)-4.png)
Códigos de error de FedEx de valor aduanero y exportación
¿Por qué veo el error “FedEx invalid customs value”?
Si les aparece este error, significa que:
- El campo Total Sales del pedido y el Unit Value del CN22 deben coincidir.
- El importe mínimo exigido es 1 €
¿Por qué veo el error “EXPORTDETAIL.DATA.MISSING - Export detail data is missing in this shipment. Please update and try again"?
Este error indica que deben completar el parámetro B13A, que el transportista exige en estos casos. Tendrán que añadir la siguiente Carrier Option:
Aquí tienen más información de la web de FedEx sobre cuándo se exige el B13A: FedEx | System Down
¿Por qué veo el error "TOTALCARRIAGEVALUE.EXCEEDS.CUSTOMSVALUE"?
Comprueben que el valor total del pedido, el total del CN22 y el Declared Value coincidan.
Si les aparece este error, prueben a aumentar ligeramente el importe TotalValue y vuelvan a intentar el envío.
¿Por qué veo el error "TOTALCUSTOMSVALUE.REQUIRED - Customs Value is required field."?
Este envío requiere documentos aduaneros. Si necesitan ayuda para continuar, no duden en contactar con nuestro equipo de soporte.
¿Por qué veo el error "CURRENCY.TYPE.INVALID - The currency type you selected is invalid. Please select another currency type.COMMODITY_INDEX"?
Consulten con su gestor de cuenta de FedEx o con el soporte de FedEx si la divisa seleccionada es compatible con el tipo de envío y el servicio que están utilizando.
¿Por qué veo el error: CUSTOMS.VALUE.INVALID - The recipient country doesn’t accepts zero or null as customs value.Please update and try again.
Si el país del destinatario no acepta envíos con un valor inferior a 1, deben ajustar el precio declarado del pedido antes de volver a enviar.
Errores de FedEx en la factura comercial
¿Por qué veo el error “Commercial Invoice is Required”?
Normalmente significa que no se ha subido ninguna factura comercial (necesaria para todos los pedidos internacionales). Si ocurre aunque hayan subido la factura correctamente, prueben a subir el logotipo de su empresa en la sección Sender info de su perfil y a hacer lo mismo en su perfil de FedEx, asegurándose de que coincidan. Una vez hecho esto, intenten corregir el pedido con el botón “Fix order”.
¿Por qué veo el error "SHIPMENT.ELECTRONICIMAGE.REQUIRED - This COMMERCIAL_INVOICE requires electronic image. Please update and try again."?
Este mensaje de error aparece cuando FedEx exige dos imágenes electrónicas obligatorias para completar el envío:
- El membrete de la factura
- La firma de la factura
Para corregir este error y continuar correctamente con el envío, deben subir estas dos imágenes directamente en la ventana de configuración del transportista FedEx.
Cómo hacerlo:
- Abran la ventana de configuración de FedEx haciendo clic en el botón "Edit" de la sección Carriers.
- Seleccionen la opción "Generate Invoice with FedEx format (in order to print the commercial invoice along with the label)" para activar el envío de la factura electrónica junto con la etiqueta.
- Suban la imagen del membrete de la factura en formato PNG o GIF en la sección "Upload a new PNG or GIF Image for the Invoice's letterhead".
- Suban la imagen de la firma en la sección "Upload a new PNG or GIF Image for the Invoice's signature".
📌 Requisitos de las imágenes:
Solo se admiten los formatos PNG y GIF, con los siguientes límites de tamaño:
- Membrete: 700x50 píxeles, máx. 60 KB
- Firma: 240x25 píxeles, máx. 60 KB
Para envíos a algunos destinos europeos, FedEx puede exigir el documento AWB como requisito obligatorio, así que prueben a quitar esta casilla en la conexión de FedEx y a volver a procesar el envío:
Si ninguna de las sugerencias anteriores les ayuda y están subiendo su propio ETD, contacten con el equipo de soporte y les ayudaremos a resolverlo.
¿Por qué veo el error "Invalid input: please, check your data again."?
El error tiene que ver con el formato del documento subido. Prueben a utilizar el formato GIF.
¿Por qué veo el error "You are requesting the transmission of 2 different invoices. Remove ETD file or disable “Generate Commercial Invoice” in carrier settings."?
Este error se produce cuando seleccionan la opción "Generate Commercial Invoice" en la ventana de conexión y después suben la documentación ETD para el mismo envío.
Como estas dos opciones no son compatibles, deben:
- Subir la documentación o seleccionar "Generate Commercial Invoice" en la ventana.
¿Por qué veo el error “SHIPPING_DOCUMENT - COMMERCIAL_OR_PRO_FORMA_INVOICE SHIPPING.DOCUMENT.REQUIRED - COMMERCIAL_OR_PRO_FORMA_INVOICE is required to process your electronic trade document request”?
La factura comercial USMCA solo se acepta para envíos con origen en Estados Unidos (exportaciones de EE. UU.).
¿Por qué veo el error “COMMERCIAL_OR_PRO_FORMA_INVOICE is required to process your electronic trade document request”?
Prueben a quitar la casilla "Avoid generation of AWB for intra-EU shipments"
Si no consiguen solucionarlo, contacten con nuestro soporte por chat o ticket.
¿Por qué veo el error “The COMMERCIAL_INVOICE requires an electronic LETTER_HEAD”?
Si están usando la conexión antigua de FedEx, conecten FedEx v2 y suban allí el membrete.
¿Por qué veo el error “SHIPPINGDOCUMENTSPECIFICATION.CUSTOMERIMAGEUSETYPE.NOTFOUND - Letterhead and/or Signature images could not be retrieved."?
Este error puede deberse a una subida incorrecta del membrete y/o de la firma. Les sugerimos volver a subirlos desde la sección Carriers, teniendo en cuenta los siguientes límites:
- Imagen de la firma: 240x25 píxeles, 60KB
- Imagen del membrete: 700x50 píxeles, 60KB
¿Por qué veo el error “COMMERCIAL_INVOICE requires an electronic SIGNATURE"?
Si están usando la conexión antigua de FedEx, conecten FedEx v2 y suban la firma.
¿Por qué veo el error “FedExv2:In order to generate a commercial invoice, you must upload your letterhead image and signature in the carrier settings. Please upload new images and try again."?
Vayan a la sección Carriers y comprueben que los documentos exigidos estén subidos correctamente en los ajustes de la conexión de FedEx, en "Upload a new PNG or GIF Image for the invoice's letterhead":
¿Cómo puedo evitar que se generen cuatro etiquetas en los envíos de FedEx?
Para evitar que se creen cuatro etiquetas en los envíos de UE a UE con FedEx, basta con activar esta casilla en los ajustes de la conexión del transportista:
Avoid generation of AWB for intra-EU shipments
SHIPPING.DOCUMENT.REQUIRED: COMMERCIAL_INVOICE is required to process your electronic trade document request.
El país de destino no acepta la factura generada a través de FedEx. Desactiven la configuración en los ajustes de FedEx, en Carriers > FedExv2 > Edit, y adjunten manualmente su propia factura al envío.
¿Por qué la vista previa de la factura comercial de FedEx se ve bien, pero algunos campos aparecen vacíos al descargar el archivo?
Se trata de un problema de compatibilidad del PDF generado directamente por FedEx, que puede darse con algunos lectores de PDF como Adobe Acrobat y Microsoft Edge. Prueben a abrir el archivo con otro lector de PDF, como Chrome o Firefox.
Errores de FedEx con ETD y envíos paperless
¿Por qué veo el error “Document is Invalid”?
El error Document is Invalid suele deberse a una falta de coincidencia entre la primera llamada de subida y la llamada de envío propiamente dicha.
¿Qué puedo hacer para solucionarlo?
Lo primero, comprueben aquí que el país al que envían admite la documentación ETD.
Si no es el caso, comprueben si el mismo Document ID ya se ha utilizado en otros envíos.
¿Por qué veo el error "There was an error uploading ETD to FedEx: Authentication Failed. Please try uploading a new ETD for this order''?
Les sugerimos contactar con su gestor de cuenta de FedEx para revisar los ajustes de su cuenta y verificar que hayan activado su API para envíos Paperless.
¿Por qué veo el error "There was an error uploading ETD to FedEx: The file you entered is corrupted by a virus and cannot be uploaded. Please use virus scanning software to sanitize the file prior to submitting it.. Please try uploading a new ETD for this order."?
Si les aparece este error, les sugerimos analizar el archivo con un antivirus. Si no funciona, generen y suban un archivo nuevo.
¿Por qué veo el error “The ETD document type you uploaded is not supported by FedEx v2. Please retry with a different ETD document type. Supported types are: PRO_FORMA_INVOICE, CERTIFICATE_OF_ORIGIN, USMCA_COMMERCIAL_INVOICE_CERTIFICATION_OF_ORIGIN, COMMERCIAL_INVOICE."?
Este error puede producirse por varios motivos:
- Es posible que el tipo de ETD seleccionado no sea correcto. Cambien el tipo de documento en la pestaña Details & Documents.
Por ejemplo:
- Commercial invoice (o valor 5 vía API) para la factura
- Other (o valor 99 vía API) para la declaración de aduanas
- Si envían a un país de la Unión Europea, puede aparecer este error porque los documentos ETD no son necesarios para los envíos a países de la UE.
- Es posible que les aparezca este error porque la configuración paperless está desactivada. Vayan a Carriers > FedEx v2 > Edit y comprueben que la opción esté seleccionada:
¿Por qué veo el error “You are requesting Paperless service: please upload an ETD file or enable “Generate Invoice with FedEx format” in carrier settings."?
Comprueben si la opción “Paperless” está activada en su conexión del transportista FedEx, en la sección Carriers. Si lo está, desactívenla y vuelvan a procesar el envío.
¿Por qué veo el error “General Failure”?
Si están creando un envío internacional, tengan en cuenta que FedEx acepta un máximo de 5 ETD. Si han subido más, prueben a unirlos en un único PDF.
¿Por qué veo el error “SPECIAL_SERVICE_TYPE - ELECTRONIC_TRADE_DOCUMENTS ORGORDEST.SPECIALSERVICES.NOTALLOWED - This special service type is not allowed for the origin/destination pair. Please update and try again"?
La casilla "Avoid generation of AWB for intra-EU shipments”, en Carriers>FedExv2>Edit, no se puede activar para las devoluciones.
¿Por qué veo el error “SHIPMENTSPECIALSERVICES.ETDDETAIL.NOTAVAILABLE - Electronic trade documents are not available for domestic shipments. Please update and try again."?
Si están procesando envíos nacionales, puede aparecer este error por los siguientes motivos:
- Han seleccionado las opciones "Paperless" y "Generate Invoice" en los ajustes de la conexión del transportista. Solución: quiten la casilla.
- Han seleccionado "Avoid generation of AWB for intra-EU shipments” en los ajustes de la conexión del transportista. Solución: quiten la casilla.
¿Por qué veo el error “There was an error while uploading the file. Please try again later”?
Si el error aparece en un envío internacional con ETD, vuelvan a convertir el archivo ETD, súbanlo de nuevo y eliminen el anterior.
Solucionen los errores de FedEx desde un solo lugar
Conecten FedEx y el resto de sus transportistas a la plataforma de envíos ShippyPro y corrijan cada pedido con error desde la sección Orders > Errors.
Errores de FedEx de dirección, código postal y teléfono
¿Por qué veo el error “I dati inseriti nel parametro NONE sono invalidi. Azione di riferimento: NONE"?
FedEx no admite todos los caracteres especiales en las etiquetas. Para solucionar este error, eliminen los caracteres especiales de la solicitud de etiqueta, prestando especial atención a los campos Notes e Item Description.
¿Por qué veo el error "ErrorMessage": "STREETLINES.TOO.LONG - We are unable to process this request. Please try again later or contact FedEx Customer Service."?
El límite máximo para FedEx es de 35 caracteres.
¿Por qué veo el error “RECIPIENT.STATEORPROVINCECODE.INVALID. We are unable to process this request”?
Comprueben que el campo Provincia/Estado del destinatario sea correcto, o simplemente elimínenlo.
¿Por qué veo el error “SHIPPER.STATEORPROVINCECODE.INVALID. Shipper State or Province code is invalid”?
Comprueben que el campo Provincia/Estado del remitente sea correcto, o simplemente elimínenlo.
¿Por qué veo el error “VALUE.TOO.LONG - CustomerReference value is invalid for customer reference 2 in requestedPackage 1. Please update and try again."?
La nota para el transportista es demasiado larga: acórtenla y vuelvan a procesar el envío.
¿Por qué veo el error “Zip code must be at least 6 characters"?
Si envían al Reino Unido, asegúrense de que el código postal introducido sea correcto. Tengan en cuenta que puede haber espacios entre los caracteres del código postal: no los eliminen.
¿Por qué veo el error “Street 1 and Street 2 cannot be longer than 35 characters. Please enter a shorter address or split it between the two fields"?
Reduzcan la longitud de Address 1 y Address 2 a un máximo de 35 caracteres en total.
¿Por qué veo el error “RECIPIENT.STATEORPROVINCECODE.INVALID - Destination country is not serviced. Please update and try again."?
Si les aparece este error al enviar a las Islas Canarias, revisen los detalles del envío y asegúrense de introducir correctamente la siguiente información:
- Usen el código "ES" en el campo "State/Province"
- Introduzcan "Spain" en el campo "Country".
¿Por qué veo el error “FedExv2:DESTINATION.POSTALCODE.MISSING.ORINVALID - Destination postal code missing or invalid."?
Comprueben que el campo del código postal esté completado y que sea correcto.
¿Por qué veo el error "PHONENUMBER.TOO.SHORT - Phone no. must be 10 digits for U.S. and Canada.Please update and try again"?
FedEx no acepta números de teléfono que empiecen por el dígito 0, ya que los interpreta como números de menos de 10 dígitos.
¿Por qué veo el error "Could not interpret numbers after plus-sign"?
Asegúrense de que los números de teléfono del remitente y del destinatario incluyan el prefijo internacional correcto.
¿Por qué veo el error "SHIPPER.POSTALSTATE.MISMATCH - Shipper Postal-State Mismatch. Please correct and try again."?
Eliminen la provincia del campo ‘state’ o ‘province’ del remitente. Dejen el campo vacío.
¿FedEx acepta caracteres griegos?
No, el transportista no admite caracteres griegos, solo caracteres latinos.
FedExv2 - FEDEX EU CONNECT PLUS 2025: -DESTINATION.POSTALCODE.MISS ING.ORINVALID -Destination postal code missing or invalid.
Comprueben que el código postal del envío no contenga caracteres especiales ni espacios dobles.
Errores de FedEx de tipo de servicio y destino
¿Por qué veo el error “Return: Number of packages exceeds maximum”?
Si les aparece el error "Return: Number of packages exceeds maximum" en sus envíos de FedEx, ¡este es el motivo!
Como pueden imaginar, el problema tiene que ver con las devoluciones: FedEx no acepta 2 bultos en las devoluciones.
Siempre pueden crear una nueva etiqueta de devolución manual para su envío.
¿Por qué veo el error “Airbill is not allowed for Destination Country”?
Si les aparece este error, es posible que el servicio de envío seleccionado no esté disponible o permitido para el país de destino en cuestión. En ese caso, consulten directamente con el transportista cuál es el servicio más adecuado para este destino, o prueben a seleccionar 'All Services' en la ventana de conexión del transportista (Carriers > FedEx > Edit > Service > “All Services”).
¿Por qué veo el error “International Shipments cannot be voided at the package level”?
Este error significa que no pueden modificar un envío ya creado: en este caso, creen un nuevo envío desde cero.
¿Por qué veo el error “Destination country does not accept international non-document shipments”?
El error indica que, para el destino introducido (por ejemplo, Andorra), los envíos sujetos a impuestos, es decir, todo lo que no sea un envío de documentos, no son válidos.
¿Por qué veo el error “FedEx International Priority is deprecated. Please select another service"?
Pueden corregirlo seleccionando el servicio "FedEx International Priority" en lugar del servicio International Priority.
¿Por qué veo el error “RATE.LOCATION.NOSERVICE - FedEx service is not currently available to this origin / destination combination. Enter new information or contact FedEx Customer Service."?
Para este error hay 3 posibles soluciones:
- Consulten con el transportista si tienen permiso para enviar a este destino. Comprueben también que los detalles del pedido sean correctos y no contengan caracteres especiales ni espacios vacíos.
- Prueben a eliminar cualquier opción adicional (por ejemplo, Courier Options o servicios adicionales seleccionados en la conexión del transportista, como “Delivery Signature”).
- Este error puede producirse si el Packaging Type seleccionado en la conexión del transportista no es correcto. Por ejemplo, la opción Envelope solo puede usarse para envíos de 0,5 kg o menos. Si su envío supera este peso, seleccionen Your Packaging y vuelvan a intentarlo.
¿Por qué veo el error "REQUESTEDSHIPMENT.SERVICETYPE.UNSUPPORTED - Service type is not supported at the moment. Please contact FedEx customer service for more information."?
Comprueben que el servicio que están utilizando sea compatible con el envío que intentan crear.
Si envían vía API, asegúrense de seleccionar el servicio concreto que quieren usar tanto en la Carrier Connection como en el parámetro CarrierService de la llamada API (All Services no se aceptará).
¿Por qué veo el error "SERVICETYPE.NOT.ALLOWED. selected service type is not allowed between origin and destination. Please update and try again"?
El servicio o algunos datos podrían no ser correctos.
Cómo solucionarlo:
- Asegúrense de no dejar ningún campo vacío en la sección de la dirección.
- Seleccionen el servicio correcto (para envíos nacionales, usen un servicio nacional, no uno internacional).
¿Por qué veo el error: REQUESTEDSHIPMENT.SERVICETYPE.NOTSUPPORTED - FEDEX_INTERNATIONAL_CONNECT_PLUS is not supported for the destination. Please update and try again
Algunos países, como Malta y Croacia, no aceptan para las devoluciones el servicio indicado en el error. Contacten con su referente de FedEx para obtener una alternativa válida.
WARNING: "Invalid Value in Service Type. Please update and try again."
El error "Invalid Value in Service Type" indica que el servicio de FedEx seleccionado no es válido o no es compatible con el destino elegido.
Les recomendamos comprobar lo siguiente:
- Verifiquen que han seleccionado el servicio de FedEx correcto en la configuración del transportista en ShippyPro para los envíos al país de destino. Si no están seguros, prueben a seleccionar "All Services" en los ajustes de la conexión para ver todos los servicios disponibles.
- Consulten directamente con FedEx qué servicios están habilitados para envíos B2C al país de destino, ya que algunos servicios podrían no estar disponibles o permitidos para ese destino.
- Asegúrense de que todos los detalles del envío (peso, dimensiones y tipo de embalaje) cumplan los requisitos de FedEx para el servicio y el destino seleccionados.
Códigos de error de FedEx de Carrier Options, servicios especiales y API
¿Por qué veo el error “Invalid booking confirmation number” o “BOOKING.CONFIRMATION.NUMBER.INVALID”? - Booking confirmation number is invalid. SHIPMENT.LOADCOUNT.INVALID - Invalid shipper load and count.?
Deben contactar con su gestor de cuenta de FedEx y pedir un número de reserva de recogida, que tendrán que introducir en la Carrier Option "Booking Confirmation Number".
La opción solo está disponible con los siguientes servicios de envío: FedEx International Priority Freight, FedEx International Economy Freight, FedEx Regional Economy Freight
Nota: recuerden que, si envían vía API, pueden configurar esta Carrier Option en la llamada Ship de la siguiente manera:
{
"CarrierOptions": [
{
"name": "fedexv2booking_confirmation_number",
"value": "<insert a value here>"
}
]
}Lean el artículo How can I add Carrier Options to my shipments?
¿Por qué veo el error “Special service SIGNATURE_OPTION is invalid”?
Este error se produce porque la firma indirecta (Indirect Signature) solo puede solicitarse para direcciones residenciales. Les recomendamos contactar con FedEx y, si es posible, realizar el envío con esta opción directamente con ellos.
¿Por qué veo el error “SPECIAL_SERVICE_TYPE-CODORGORDEST.SPECIALSERVICES.NOTALLOWED”?
Si les aparece este error, están solicitando el servicio de contra reembolso (COD). Tengan en cuenta que el servicio COD de FedEx ya no está disponible en EE. UU. ni en Canadá y solo está disponible parcialmente en el resto del mundo. Contacten con su gestor de cuenta de FedEx para saber más sobre este servicio.
¿Por qué veo el error “FedEx does not support insurance. Please use Declared Value carrier option instead”?
Si les aparece este error, están solicitando un seguro para un envío. FedEx no ofrece seguro. Como alternativa, pueden usar el FedEx Declared Value. Sigan este enlace para saber más sobre el Declared Value.
¿Por qué veo el error "SHIP.SPECIALSERVICE.INVALID - Package 1 - Special service SIGNATURE_OPTION is invalid"?
Si han seleccionado la opción Indirect Signature, asegúrense de incluir también la Carrier Option:
{
"fedexv2receiver_address_type": {
"Receiver Address Type": "",
"Residential": "residential"
}
}¿Por qué veo el error "SpecialServicesRequested dangerousGoodsDetail - Invalid dangerousGoodsAccessibilityType in RequestedPackage 1"?
Asegúrense de usar la integración FedEx v2 y seleccionen “Limited Quantities Commodities” en la Carrier Option Dangerous Goods.
¿Por qué veo el error "Fedex LOCATION_ID_TYPE - XHNGW HOLDATLOCATIONDETAIL.LOCATIONID.INVALID - Hold At Location Id is invalid. Please update and try again."?
El Point ID introducido en la Carrier Option no es válido.
Cómo activar la opción "IsDocumentOnly" en un envío vía API
Si solo envían documentos, deberán declarar el campo "CustomInfoContentsType": "documents" en su llamada API.
¿Cómo puedo añadir un seguro para cada bulto?
Ahora pueden indicar el valor declarado de cada bulto directamente en el elemento parcels de su solicitud SHIP, añadiendo los siguientes atributos en el objeto Attributes de cada bulto:
"parcels": [
{
"length": 5,
"width": 5,
"height": 5,
"weight": 10,
"Attributes": {
"declaredValue": 100.55,
"declaredValueCurrency": "USD"
}
},Añadan los campos declaredValue y declaredValueCurrency a cada bulto para el que quieran definir un valor declarado específico.
He hecho clic en el botón "Return label in the box", pero el menú desplegable que aparece está vacío. ¿Por qué?
Con ese menú pueden seleccionar una dirección concreta como destino de las devoluciones. Para más información, les invitamos a consultar el artículo dedicado a la conexión de FedEx: How to connect FedExv2
Qué significa este error: PACKAGE_INDEX - 1 LOCATION_ID_TYPE - HOLD_AT_LOCATION COUNTRY.POSTALCODEORZIP.INVALID - Invalid postal code/ZIP for the country selected. Please correct and try again.
No es posible entregar en el punto seleccionado. Comprueben las restricciones de peso y tamaño de ese punto o punto de recogida.
Error: LOCATION_ID_TYPE - HOLD_AT_LOCATION HOLDATLOCATIONDETAIL.LOCATIONID.INVALID - Hold At Location Id is invalid. Please update and try again
El punto de recogida no puede recibir paquetes: solo puede enviarlos.
Códigos de error de FedEx en las recogidas
¿Por qué veo el error “Missing or invalid postalCode”?
Si les aparece este error al reservar una recogida con FedEx, comprueben que el código postal se haya introducido correctamente y con el formato adecuado. Si todo está bien, contacten con su representante de FedEx para verificar si están autorizados a organizar recogidas desde el país seleccionado.
¿Por qué veo el error “weight.value is missing or invalid” al solicitar una recogida?
FedEx solo permite reservar recogidas de bultos de más de 65 kg a través de su portal, así que tendrán que ir al portal del transportista y reservar la recogida directamente allí.
¿Por qué veo el error “PICKUP.STATEORPROVINCECODE.MISSING - GENERIC.ERROR”?
Para las solicitudes de recogida en Quebec y Terranova, el campo "State" debe completarse con "PQ" y "NL" respectivamente, en lugar de sus códigos ISO habituales (que serían QC y NF).
¿Por qué veo el error "ORIGINDETAIL.READYDATETIMESTAMP.REQUIRED - GENERIC.ERROR"?
Si les aparece este error al reservar una recogida, comprueben que la hora seleccionada esté dentro del horario de apertura del almacén local y entre las horas mínima y máxima previstas para la recogida.
¿Por qué veo el error "PICKUP.WEIGHT.VALUE.INVALID - Invalid or missing weight value"?
Si les aparece este error al programar una recogida, asegúrense de que su envío cumpla los límites de peso de FedEx. Si tienen dudas, les recomendamos consultar a su representante de FedEx.
¿Por qué veo el error "ORIGINDETAIL.READYDATETIMESTAMP.AFTERCUTOFFTIME"?
Explicación: la hora de preparación está programada después del cut-off del almacén (comprueben los horarios exactos con el transportista).
Cómo solucionarlo: actualicen la hora dentro del intervalo permitido en los campos "PickupTime" y "PickupAfternoonMaxtime".
¿Por qué veo el error "PICKUP.NUMBER.EXPIRED - PREVIOUS DAY PICKUP, CANNOT CANCEL OR UPDATE"?
El error de FedEx indica que ya es demasiado tarde para hacer cambios online. Como el sistema no puede procesar actualizaciones ni cancelaciones de solicitudes de días anteriores, deben contactar con el servicio de atención al cliente de FedEx para cancelar o reprogramar su envío.
Códigos de error de FedEx de cuenta y autenticación
¿Por qué veo el error “Inactive customer account”?
Si les aparece el mensaje de error Inactive customer account en un envío de FedEx, les invitamos a contactar directamente con el servicio de atención al cliente de FedEx para conocer el origen del problema.
Después, pueden actualizar sus envíos en ShippyPro haciendo clic en Actions > Fix orders in error in bulk desde la sección Shipping Labels.
¿Por qué veo el error “Customer is cash only”?
Es posible que la cuenta utilizada esté asociada a una tarjeta de crédito caducada o tenga algún otro problema de facturación. Si la cuenta de FedEx no se mantiene al día, puede pasar al estado "cash only".
¿Por qué veo el error “Meter number is not registered”?
Vayan a la sección Carrier y quiten la casilla de la opción "test mode".
¿Por qué veo el error “PAYMENT.PAYORCOUNTRY.INVALID”?
Si les aparece este error, están intentando enviar desde un país que no es compatible con su cuenta de FedEx (por ejemplo, tienen una cuenta de EE. UU. e intentan enviar desde un país europeo).
¿Por qué veo el error “FORBIDDEN.ERROR - We could not authorize your credentials. Please check your permissions and try again."?
Si este error aparece cuando las credenciales son correctas o no se han modificado, prueben a volver a procesar el pedido, ya que puede deberse a una ralentización por parte de FedEx.
¿Por qué veo el error “The city, State/Province and ZIP/Potal code combination that you entered is not valid"?
Si aparece este mensaje al conectar FedEx v2, comprueben que las credenciales, el nombre y la dirección en ShippyPro coincidan exactamente con los de la cuenta de FedEx, en la sección Billing address.
¿Por qué veo el error "GROUND.SHIPPING.NOTAUTHORIZED - Ground shipping is not authorized for this User."?
FedEx no ha autorizado el servicio FedEx Ground para este usuario.
¿Por qué veo el error: ACCOUNTNUMBER.MINIMUMLENGTH.REQUIRED - Enter a valid 9-digit FedEx account number?
Comprueben que el Account Number introducido en su conexión de FedEx sea correcto. Además, si utilizan el Incoterm EXW, asegúrense de introducir un Account Number válido para la parte a la que quieren facturar el envío.
¿Por qué veo el error ACCOUNT.NUMBER.INVALID - Account number not found. Please provide a valid account number.
Significa que el transportista no puede procesar este envío porque el número de cuenta:
- ❌ Falta: no se ha proporcionado ningún número de cuenta
- ❌ No es válido: el número de cuenta proporcionado no existe o no tiene el formato correcto
- ❌ Está inactivo: el número de cuenta ya no está activo con el transportista
Para resolver este problema:
- Comprueben que su número de cuenta de FedEx sea correcto y esté activo
- Actualicen la información de la cuenta de envío en la página Carriers de ShippyPro
- Contacten con el soporte de FedEx si no están seguros de su número de cuenta o si su cuenta se ha desactivado
Errores de servidor y de sistema de FedEx
¿Por qué veo el error “Resources unavailable to service request”?
Es posible que el servidor del transportista esté caído. Esperen e intenten corregir los pedidos con error más tarde.
¿Por qué veo el error “SYSTEM.UNEXPECTED.ERROR - GENERAL FAILURE {FAILURE_CAUSE}. Please update and try again."?
Este error indica una caída temporal del servidor por parte del transportista. Intenten corregir el pedido más tarde.
¿Por qué veo el error "INTERNAL.SERVER.ERROR - We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."?
Este error indica una caída temporal del servidor por parte del transportista. Intenten volver a procesar los pedidos con error más tarde.
Nota: si el error persiste solo en un envío concreto mientras los demás se generan correctamente, significa que el servidor de FedEx no puede procesar ese envío en particular (por ejemplo, porque tiene demasiados ETD adjuntos).
¿Por qué veo el error “An error occurred while processing your shipment. Please try again later"?
Si les aparece este error en todos sus envíos durante GetRates/la selección del transportista, es posible que haya una ralentización momentánea por parte del transportista. Vuelvan a intentarlo más tarde.
Si les aparece este error durante GetRates/la selección del transportista solo en uno o algunos pedidos concretos, es posible que el pedido contenga caracteres especiales o combinaciones de caracteres (por ejemplo, una palabra concreta seguida de paréntesis) bloqueados por el firewall del transportista. Prueben a eliminar todos los caracteres especiales o creen un envío manual desde cero.
¿Por qué veo el error "CXS JWT is expired"?
Puede tratarse de una ralentización temporal del servidor del transportista: prueben a volver a procesar la etiqueta.
¿Por qué veo el error "SERVICE.UNAVAILABLE.ERROR - The service is currently unavailable and we are working to resolve the issue. We apologize for any inconvenience."?
Si les aparece el error al intentar reservar una recogida, vuelvan a intentarlo más tarde.
Tarifas, impuestos y plazos de tránsito de FedEx
¿Por qué las tarifas de FedEx aparecen como €0 o n/a?
Contacten con FedEx: es posible que las tarifas negociadas no estén disponibles. El servicio de atención al cliente de FedEx podría responderles lo siguiente:
Debido a la integración de TNT en FedEx y por motivos legales, en este momento ninguna solución informática de FedEx permite acceder a los precios.
Prevemos que esta funcionalidad estará activa durante el primer trimestre de 2025.
¿Por qué veo una diferencia en los días de entrega?
Si un envío dentro de Europa tiene una fecha de entrega más larga que la indicada en su contrato o en la web de FedEx, revisen el campo “description”:
- debe estar siempre en inglés
- debe ser breve (por ejemplo, SAMPLE, DOCUMENTS)
Si un envío fuera de Europa tiene una fecha de entrega más larga que la indicada en su contrato o en la web de FedEx, revisen el campo “description”:
- debe estar siempre en inglés;
- debe ser lo más precisa posible (por ejemplo, "cosmetics" NO, "Extra Face & Eye Cream 50 ml Anti wrinkle (x1)" SÍ). Para EE. UU., Canadá y México los controles sobre la descripción de la mercancía son muy estrictos.
Además, asegúrense de que los códigos postales de EE. UU. tengan 5 dígitos.
¿Por qué veo el error RATEQUOTE.SHIPMENTPROCESSING.ERROR?
Las tarifas y los plazos de tránsito no están disponibles para el número de cuenta introducido. Contacten con el servicio de atención al cliente local de FedEx.
¿Por qué no veo ninguna diferencia entre las tarifas con y sin impuestos en los envíos fuera de la UE?
FedEx no devuelve ningún dato fiscal (IVA, etc.) para los envíos fuera de la UE. Estos costes los añadirá después el transportista en la factura de pago.
¿Por qué los plazos de tránsito de FedEx son distintos de los que veo en el portal de FedEx?
Esta diferencia se debe a que FedEx no siempre facilita esta información en sus respuestas de tarifas por API. Por eso no es posible alinear nuestros datos con los de la plataforma de FedEx, ya que no tenemos acceso a la información necesaria. Si no recibimos el plazo de tránsito de FedEx, mostramos 1 día por defecto.
Códigos de error de FedEx: preguntas frecuentes
¿Cuáles son los errores de envío de FedEx más comunes?
La mayoría de los errores de envío de FedEx tienen pocas causas: pesos que no coinciden entre el bulto y el CN22, descripciones de mercancía vagas o vacías, campos de dirección de más de 35 caracteres o con caracteres especiales, imágenes o archivos ETD que faltan para la factura comercial y servicios no disponibles para el destino elegido.
¿Cómo se solucionan los errores de FedEx en ShippyPro?
Vayan a Orders > Errors, revisen el Error Type y el Error Message, hagan clic en "How to Fix?" para ver la solución sugerida y después usen el icono de la llave inglesa para abrir el pedido y corregir los campos vacíos o incorrectos.
¿Por qué FedEx considera que la descripción de la mercancía es vaga o incompleta?
FedEx sigue las directrices de la Comisión Europea y rechaza descripciones genéricas como "gift" o "pants". Usen una descripción concreta en inglés, de un máximo de 35 caracteres, tanto en los detalles del pedido como en el CN22.
¿Por qué FedEx indica que el peso de la mercancía supera el peso del bulto?
FedEx espera que el peso total del bulto incluya el embalaje, por lo que debe ser ligeramente superior a la suma de los pesos de los artículos declarados en el CN22. Aumenten el peso total y vuelvan a procesar el envío.
¿Qué significa el error de FedEx "General Failure"?
En los envíos internacionales suele significar que se han adjuntado más de 5 archivos ETD: únanlos en un único PDF. El mensaje "SYSTEM.UNEXPECTED.ERROR - GENERAL FAILURE", en cambio, indica un problema temporal por parte de FedEx, así que vuelvan a intentarlo más tarde.
¿Cuál es la longitud máxima de dirección que acepta FedEx?
FedEx acepta un máximo de 35 caracteres en las líneas de dirección: acorten Address 1 y Address 2 o repartan la dirección entre los dos campos.
¿Qué significa "FedEx invalid customs value"?
El campo Total Sales del pedido y el Unit Value del CN22 no coinciden, o el valor declarado es inferior al mínimo de 1 €. Igualen los valores y corrijan el envío.
¿Por qué FedEx indica que el servicio no está disponible para mi destino?
Es posible que el servicio seleccionado no esté permitido para ese origen y destino. Consulten con FedEx qué servicio usar, prueben a seleccionar "All Services" en la conexión del transportista, eliminen las opciones adicionales y comprueben que el tipo de embalaje sea adecuado para el peso del envío.
¿FedEx ofrece seguro de envío?
No. FedEx no ofrece seguro, pero pueden usar la Carrier Option Declared Value, incluso con un valor declarado por bulto si envían a través de la API de ShippyPro.
¿Qué tamaño deben tener el membrete y la firma de la factura comercial de FedEx?
Solo se admiten archivos PNG y GIF. El membrete debe medir 700x50 píxeles y la firma 240x25 píxeles, cada uno con un tamaño máximo de 60 KB.
Menos tiempo perdido con los errores de etiquetas de FedEx
Prueben ShippyPro gratis durante 14 días y gestionen FedEx junto con el resto de sus integraciones con transportistas y marketplaces.
ShippyPro es el software de envío completo para el comercio online y offline. Con las funciones Label Creator, Track & Trace, Easy Return y Analytics, nuestro software simplifica sus operaciones de envío. ShippyPro se integra con más de 180 transportistas y 80 canales de venta, por lo que es compatible con una amplia gama de productos y casos de uso.