Cree etiquetas para paquetes con FileMaker y la API de DHL
La conexión de FileMaker con la API REST de DHL permite la creación automatizada de etiquetas de paquetes para envíos. En esta guía paso a paso, aprenderá a programar FileMaker para que su solución FileMaker se comunique con la API REST de DHL para solicitar y descargar etiquetas de paquetes.
La API de DHL puede utilizarse para automatizar una amplia gama de procesos de envío y seguimiento. Además de crear etiquetas de paquete (etiquetas de envío), los usuarios también pueden automatizar el seguimiento para controlar el estado de sus paquetes en tiempo real. La API también permite crear etiquetas de devolución para simplificar las devoluciones a los clientes. Además, los documentos de envío importantes, como las declaraciones de aduana para envíos internacionales, pueden crearse directamente e integrarse en el proceso de envío. Además, se pueden priorizar los envíos o añadir determinadas opciones de envío como el pago contra reembolso o el seguro. La API de DHL ofrece así una solución completa para optimizar todo el proceso de envío e integrarlo completamente en sistemas existentes como FileMaker. En esta guía, le mostraremos cómo crear etiquetas de paquetes con la API.
Cuatro plataformas FileMaker ERP con CRM y gestión de mercancías para optimizar los procesos operativos.
Solicitar información
Requisitos previos
- Una cuenta de cliente comercial de DHL con acceso a la API de Cliente Comercial de DHL.
- Los datos de acceso a la API REST de DHL, es decir, clave de API, nombre de usuario y contraseña.
- FileMaker Pro versión 16 o superior, ya que estas versiones admiten de forma nativa las solicitudes HTTP necesarias.
1. configurar la cuenta de cliente comercial de DHL y el acceso a la API
Antes de poder integrar la API de DHL en FileMaker, necesita acceder a la API de DHL:
- Vaya a la página del Portal de Desarrolladores de DHL: Portal para Desarrolladores de DHL.
- Regístrese con su cuenta de cliente profesional.
- Solicitar los datos de acceso a la API (clave API, nombre de usuario, contraseña).
- Verifique su acceso y active el servicio "DHL Shipping API".
2. primeros pasos con la API de DHL
La API de DHL utiliza peticiones HTTP para enviar y recibir datos. Las funciones más importantes para crear una etiqueta de paquete son
- AutenticaciónAutenticación básica con nombre de usuario y contraseña.
- Crear una etiqueta (etiqueta de parcela)Envíe los datos de envío y reciba la etiqueta en formato PDF.
- Recuperar la etiquetaLa devolución se realiza en formato PDF binario, que puede guardarse y utilizarse en un campo contenedor en FileMaker.
3. Guiones de FileMaker para acceder a la API de DHL
FileMaker utiliza el comando Insertar desde URL en combinación con opciones cURL para enviar peticiones HTTP a la API y recibir respuestas.
3.1 Preparar la autenticación
DHL utiliza la autenticación básica. En FileMaker, esto se consigue proporcionando el nombre de usuario y la contraseña en formato Base64. A continuación encontrará un ejemplo de cómo puede preparar la autenticación:
Base64Encode("Nombre de usuario:Contraseña")
En FileMaker, puede introducir esta cadena directamente en el campo Insertar desde URL-con las opciones cURL correspondientes.
3.2 Crear notas de expedición
La API requiere cierta información como la dirección del remitente, la dirección del destinatario, el peso, el método de envío, etc. A continuación se muestra un ejemplo sencillo de solicitud a la API de DHL para crear una etiqueta.
Script: Crear etiqueta de paquete
- Abra la ventana del área de trabajo de guión en FileMaker.
- Cree un nuevo script, por ejemplo "Crear etiqueta de parcela".
- Añade las siguientes variables para guardar los datos de envío:
Establecer variable [ $url; valor: "https://cig.dhl.de/services/production/rest/sendungsverfolgung/v2/paketmarken" ]
Establecer variable [ $auth; Valor: "Base64Encode(nombredeusuario:contraseña)" ]
Establecer variable [ $payload; Valor: "{ 'Version': '2.0', 'shipmentDetails': {...} }" ]
# Introduzca aquí los datos de envío en formato JSON
Ejemplo de la solicitud JSON (carga útil) que envía a DHL:
{
"Versión": "2.0",
"ShipmentOrder": [
{
"sequenceNumber": "1",
"Envío": {
"Expedidor": {
"Nombre": "Su empresa",
"Dirección": {
"StreetName": "Calle",
"BuildingNumber": "1",
"Código postal": "12345",
"Ciudad": "pueblo",
"CountryCode": "DE"
}
},
"Receptor": {
"nombre": "destinatario",
"Dirección": {
"StreetName": "Calle del destinatario",
"BuildingNumber": "10",
"Código postal": "54321",
"Ciudad": "ciudad destinataria",
"CountryCode": "DE"
}
},
"ShipmentDetails": {
"ProductCode": "V01PAK", # Forma de envío (por ejemplo, paquete nacional)
"WeightInKG": "2.5", # Peso del paquete
"CustomerReference": "123456", # Número de referencia
"ShipmentDate": "2023-09-01"
}
},
"LabelResponseType": "URL"
}
]
}
Utilice la Insertar desde URL-comando para enviar la solicitud a DHL y crear la etiqueta:
Insertar desde URL [ Selección ; Objetivo: $response ; URL: $url ; Opciones cURL:
"-X POST --header \"Authorisation: Basic " & $auth & "\"" &
"--header \"Content-Type: application/json\"" &
"--data " & $payload ]
3.3 Descargar y guardar la etiqueta
La etiqueta creada es devuelta por la API en forma de archivo PDF. Puede guardarlo en un campo contenedor de FileMaker.
- Inserte un campo contenedor en su base de datos FileMaker para guardar el archivo PDF.
- Cambie su script para que el archivo PDF se descargue en este campo contenedor:
Insertar desde URL [ Selección ; Destino: Campo Tabla::Contenedor ; URL: "response-PDF-URL" ]
El campo response-PDF-URL es devuelto por la API de DHL una vez que la etiqueta ha sido creada con éxito y contiene la URL donde se puede descargar el PDF.
Curso intensivo de FileMaker
FileMaker rápido y eficaz
aprendizaje en 20 capítulos.
Participe gratuitamente
4. crear carga útil JSON con FileMaker
A continuación se muestra un script de FileMaker que muestra cómo puede construir la carga útil JSON con datos de campos de FileMaker. En este ejemplo, asumimos que los campos de su base de datos FileMaker contienen información sobre el remitente, el destinatario y los detalles del envío y llamamos a su tabla "Tabla" con los nombres de campo correspondientes, que deberá adaptar convenientemente en su solución FileMaker. La estructura JSON corresponde a la que puede enviar a la API de DHL.
Ejemplo de script en FileMaker:
# Establecer variables para la estructura JSON
Establecer variable [ $jsonSender; Valor: JSONSetElement ( "{}" ;
[ "Nombre" ; Tabla::RemitenteEmpresa ; JSONString ] ;
[ "Dirección.NombreCalle" ; Tabla::RemitenteCalle ; JSONString ] ;
[ "Dirección.NúmeroDelEdificio" ; Tabla::RemitenteNúmeroDeCasa ; JSONString ] ;
[ "Dirección.CódigoPostal" ; Tabla::RemitentePLZ ; JSONString ] ;
[ "Dirección.Ciudad" ; Tabla::RemitenteCiudad ; JSONString ] ;
[ "Dirección.CódigoPaís" ; Tabla::PaísRemitente ; JSONString ]
)]
Establecer variable [ $jsonReceptor; Valor: JSONSetElement ( "{}" ;
[ "Nombre" ; Tabla::NombreDestinatario ; JSONString ] ;
[ "Dirección.NombreCalle" ; Tabla::DestinatarioCalle ; JSONString ] ;
[ "Dirección.NúmeroDelEdificio" ; Tabla::DestinatarioNúmeroDeCasa ; JSONString ] ;
[ "Dirección.CódigoPostal" ; Tabla::DestinatarioPLZ ; JSONString ] ;
[ "Dirección.Ciudad" ; Tabla::DestinatarioCiudad ; JSONString ] ;
[ "Dirección.CódigoPaís" ; Tabla::PaísDestinatario ; JSONString ]
)]
Establecer variable [ $jsonDetallesDeEnvío; Valor: JSONSetElement ( "{}" ;
[ "CódigoProducto" ; Tabla::CódigoProducto ; JSONString ] ;
[ "WeightInKG" ; Tabla::Peso de envío ; JSONNumber ] ;
[ "ReferenciaCliente" ; Tabla::NúmeroDeReferencia ; JSONString ] ;
[ "ShipmentDate" ; Table::ShipmentDate ; JSONString ]
)]
# Estructura del documento JSON completo
Establecer variable [ $payload; Valor: JSONSetElement ( "{}" ;
[ "Versión" ; "2.0" ; JSONString ] ;
[ "ShipmentOrder[0].sequenceNumber" ; "1" ; JSONString ] ;
[ "ShipmentOrder[0].Shipment.Shipper" ; $jsonSender ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.Receiver" ; $jsonEmpfänger ; JSONObject ] ;
[ "ShipmentOrder[0].Shipment.ShipmentDetails" ; $jsonVersanddetails ; JSONObject ] ;
[ "ShipmentOrder[0].LabelResponseType" ; "URL" ; JSONString ]
)]
La carga útil JSON generada se guarda en la variable $payload que puede utilizar como definición de la variable $payload en el script Crear etiqueta de paquete anterior.
ERP FileMaker personalizable con interfaces de gestión de mercancías y logística.
Más información Preguntas frecuentes sobre FileMaker y la API de DHL
- ¿Qué es la interfaz de DHL y cómo puede integrarse con FileMaker?
- La interfaz de DHL permite el envío automatizado de datos de paquetes a DHL y la recuperación de etiquetas de paquetes y datos de seguimiento de envíos. En FileMaker, puede utilizar esta interfaz para automatizar los procesos de envío y generar etiquetas de paquetes directamente desde su base de datos.
- ¿Cuáles son las ventajas de integrar la interfaz de DHL en FileMaker?
- La integración le permite ahorrar tiempo y evitar errores, ya que los datos de envío se transfieren directamente desde la base de datos de FileMaker a DHL. También puede generar etiquetas de paquetes automáticamente e integrar el seguimiento de envíos en su sistema, lo que aumenta la eficiencia en el proceso de envío.
- ¿Qué información necesito para utilizar la interfaz de DHL en FileMaker?
- Necesita los datos de acceso a la API de DHL (número de cliente, nombre de usuario, contraseña) así como los endpoints de la API de DHL. Esta información le será facilitada por DHL una vez se haya registrado para acceder a la interfaz.
- ¿Cómo puedo generar etiquetas de paquetes a través de la interfaz de DHL en FileMaker?
- Una vez que haya introducido los datos de envío, como la dirección del destinatario, el peso y el método de envío en FileMaker, puede enviar esta información a la interfaz de DHL mediante un script API. A cambio, recibirá un número de paquete y una etiqueta imprimible que puede guardar en FileMaker o imprimir directamente.
- ¿Puedo integrar el seguimiento de envíos en FileMaker?
- Sí, con la interfaz de DHL puede recuperar el número de seguimiento y guardarlo en FileMaker. Puede utilizar la API para consultar el estado actual de un paquete en tiempo real y mostrar esta información directamente en su base de datos.
- ¿La interfaz de DHL en FileMaker sólo sirve para envíos nacionales?
- No, la interfaz de DHL admite tanto envíos nacionales como internacionales. Dependiendo del destino del envío y del tipo de envío, puede transferir varios parámetros a la API de DHL en FileMaker para generar etiquetas e información de envío para diferentes países.
- ¿Es seguro el uso de la API de DHL con FileMaker?
- La comunicación con la API de DHL se realiza a través de HTTPS, lo que garantiza una transmisión de datos segura. En FileMaker, debe asegurarse de que los datos confidenciales, como los datos de acceso a la API y la información de los clientes, se almacenan y protegen en campos cifrados.
- ¿Puedo crear procesos automatizados para la interfaz de DHL en FileMaker?
- Sí, puede crear guiones en FileMaker que envíen automáticamente los datos de envío a DHL, recuperen las etiquetas de los paquetes y actualicen regularmente el seguimiento de los envíos. Estos procesos también se pueden ejecutar de forma programada para permitir la automatización completa del proceso de envío.
- ¿Qué requisitos tiene DHL para la integración de la interfaz en FileMaker?
- DHL requiere que la API se implemente correctamente, incluyendo el cumplimiento de las especificaciones de la API descritas en la documentación de la API de DHL. También debe asegurarse de que su aplicación se libera para uso productivo después de que DHL haya comprobado la implementación.
- ¿Qué debo hacer si se produce un problema al utilizar la interfaz de DHL en FileMaker?
- Si se producen problemas al comunicarse con la API de DHL, primero debe comprobar las respuestas a las solicitudes de API en FileMaker. Los códigos de error y los mensajes de DHL suelen proporcionar información detallada sobre el problema. Si las dificultades persisten, puede consultar al servicio de asistencia de DHL o la documentación técnica de la API para resolver el problema.
Resumen
Conectando FileMaker a la API REST de DHL, puede automatizar de forma eficiente la creación de etiquetas de paquetería. A continuación se resumen los pasos más importantes:
- Solicitar y configurar los datos de acceso a la API.
- Crear guiones en FileMaker para enviar datos de envío a DHL.
- Reciba y guarde etiquetas en PDF.
- Integrar la gestión de errores para supervisar las respuestas de la API.
Esta configuración le permite integrar completamente el proceso de envío en FileMaker y crear etiquetas de paquetes directamente desde su base de datos.
