Trabajando con la API de E-POSTBUSINESS
La API de E-POSTBUSINESS de Deutsche Post permite la automatización fluida del envío de cartas a través de la plataforma Document Dispatch. Al integrar esta API, todo el proceso, desde la creación digital del documento hasta la entrega física de la carta, se automatiza completamente, sin requerir ningún esfuerzo manual.
La API maneja los siguientes pasos:
- Impresión – Convierte documentos digitales en cartas físicas
- Ensobrado – Inserta automáticamente los documentos en sobres
- Franqueo – Prepara las cartas para su envío postal
Una vez que la carta está lista, Deutsche Post se encarga de la entrega, eliminando la intervención manual. Esta automatización ahorra tiempo y costos a las empresas, al tiempo que garantiza una solución de envío confiable y eficiente.
Info
Antes de poder enviar cartas con éxito, es necesario configurar la API de E-POSTBUSINESS. Puedes encontrar instrucciones detalladas de configuración aquí.
Creación y envío de un documento a través de E-POST
Con la API de E-POSTBUSINESS, los usuarios pueden enviar documentos directamente desde Business Central como cartas.
Pasos para crear y enviar una carta a través de la API:
- Navega hasta un documento (por ejemplo, una factura de venta contabilizada) en Business Central.
- Utiliza la acción Enviar E-Post en el factbox de Document Dispatch.
- Asegúrate de tener un perfil de envío para la tabla desde la cual se enviará el documento.
- Agrega los documentos o archivos adjuntos deseados y selecciona la configuración de envío específica. Estas configuraciones incluyen:
- Carta certificada
- Carta certificada con entrega en buzón (Einwurf-Einschreiben):
- La carta se entrega directamente en el buzón del destinatario sin requerir firma.
- Esta opción proporciona un seguimiento básico y una prueba de entrega que confirma que la carta ha sido depositada en el buzón.
- Ideal para documentos importantes pero no críticos, donde no se necesita una firma, como notificaciones o correspondencia general.
- Carta certificada (Einschreiben):
- La carta se entrega personalmente al destinatario o a una persona autorizada a cambio de una firma.
- El remitente recibe una confirmación de que la carta ha sido entregada, pero sin prueba adicional de quién la recibió exactamente.
- Adecuado para documentos sensibles que requieren una entrega directa, como contratos o avisos legales.
- Carta certificada con acuse de recibo (Einschreiben mit Rückschein):
- Además de la firma del destinatario, el remitente recibe una confirmación escrita de entrega (acuse de recibo).
- El acuse de recibo incluye el nombre y la firma del destinatario, sirviendo como una prueba legalmente válida de recepción.
- Recomendado para documentos altamente importantes o legalmente vinculantes, como cartas de despido, avisos legales o comunicaciones oficiales.
- Carta de presentación
- Agrega una página de portada al envío, que puede incluir información adicional o servir como separador entre diferentes secciones del documento.
- Doble cara
- Habilita la impresión a doble cara (dúplex) para ahorrar papel y hacer que el envío sea más ecológico.
- Color
- Especifica si el documento debe imprimirse en color o en blanco y negro. Esto es útil para documentos que contienen imágenes o información importante codificada por colores.
- Carta certificada con entrega en buzón (Einwurf-Einschreiben):
- Carta certificada
Note
La combinación de impresión a doble cara y carta certificada no es posible. Si seleccionas la opción de impresión a doble cara, la opción de carta certificada se desactivará.
- Selecciona la acción OK.
- Después de la confirmación en el cuadro de diálogo, la API envía automáticamente el documento a Deutsche Post, donde se imprime y se despacha.
Info
Esta función requiere una conexión API activa con Deutsche Post.
Envío de un documento mediante E-POST al extranjero
La API E-POSTBUSINESS también admite el envío internacional de documentos. Para enviar un documento al extranjero, primero deben completarse las configuraciones necesarias.
Pasos para el envío internacional:
- Navegue hasta su destinatario, por ejemplo un cliente, designado para esta configuración.
- Seleccione el destinatario y abra la ficha del destinatario.
- Configure el código de país/región del destinatario para garantizar una dirección correcta para el envío.
- Desde el menú desplegable del campo código de país/región, navegue hasta la lista completa de países/regiones.
- Si el nombre del país/región está presente en alemán en la lista completa de países/regiones, pero el idioma del entorno seleccionado de Business Central no es alemán, continúe con el siguiente paso.
- De lo contrario, si tanto el nombre como el entorno están en alemán, verifique simplemente el nombre del país y su cumplimiento con la norma ISO 3166‑1 y ajústelo si es necesario.
- Si el idioma del entorno no es alemán, las traducciones al alemán de los nombres de países/regiones deben introducirse manualmente según los requisitos de Deutsche Post.
- Estas pueden añadirse mediante la acción Traducciones en la misma página.
- Las traducciones de los nombres de países para el código de idioma DEU deben cumplir con las normas ISO 3166‑1 y ser introducidas en el campo Nombre para garantizar un envío correcto.
- Una vez completada la traducción y configurada la dirección internacional, puede enviar el documento como de costumbre mediante la acción Enviar E-Post en la FactBox de Document Central.
Info
Para realizar una auto-comprobación de la configuración, puede utilizar la acción Enviar diálogo E-Post en la FactBox de Document Central. Si la configuración es correcta, el diálogo se abrirá y mostrará el nombre del país en mayúsculas en el campo País. De lo contrario, si hay una configuración incorrecta para el envío internacional, el diálogo no se abrirá y mostrará un error.
Si el envío se realiza sin especificar un código de país (dejándolo literalmente vacío), Deutsche Post lo trata como un envío nacional. Por lo tanto, es necesario completar la configuración del código de país antes de enviar al extranjero.
Visualización del estado de envío en Business Central
Todos los envíos, incluidas las expediciones de E-Post, se enumeran y registran en la Cola de Document Dispatch. Dentro de esta cola, hay una acción específica para las entradas de E-Post llamada "Información de E-Post".
Al seleccionar esta acción, se abre una página que muestra la siguiente información:
Información general
- Número de entrada
- Documento de origen
- Indicador de modo de prueba
- Fecha de la última actualización de estado
Información de la carta
- ID de la carta
- Opciones de envío seleccionadas
Información del destinatario
- Nombre del destinatario
- Dirección del destinatario
Seguimiento del estado
Un ListPart registra todos los estados consultados, cada uno asociado con un ID de estado y un Código de estado.
IDs de estado y explicaciones:
1 - Aceptación del envío
- El envío se transmitió correctamente y no se detectaron violaciones de esquema o contenido en el JSON.
- Ubicación del estado: Después de la carga exitosa del envío.
2 - Procesamiento del envío
- Se ha verificado el cumplimiento del PDF con los requisitos de E-Post y se ha aprobado para impresión.
- Nota: A pesar de verificaciones exhaustivas, errores técnicos en el PDF pueden causar fallos de procesamiento en el centro de impresión, lo que resultará en Estado 99.
- Ubicación del estado: Pocos minutos después de la aceptación del envío.
3 - Envío al centro de impresión
- El envío ha sido transferido al centro de impresión para su producción.
- Nota: Si ocurren errores técnicos que causen un fallo en el procesamiento, se emitirá Estado 99 en lugar del Estado 4.
- Ubicación del estado: Dentro de unas horas después del procesamiento.
4 - Procesamiento en el centro de impresión
- El envío ha sido marcado como "enviado" por el centro de impresión.
- Ubicación del estado: 1-2 días hábiles después del envío al centro de impresión.
99 - Error de procesamiento
- Ver la lista de errores para más detalles.
Códigos de estado y explicaciones:
Errores: Requieren acción, el procesamiento se interrumpe
- E001 - Credenciales inválidas – Verifica los datos de inicio de sesión
- E002 - Credenciales inválidas – VendorSubID incorrecto
- E003 - Demasiadas solicitudes de SMS – Bloqueado por 15 minutos
- E004 - EKP bloqueado por Deutsche Post
- E101 - Token inválido – Expirado
- E201 - Consulta de estado inválida – No se encontró el envío
- E203 - Se detectó una desviación en los metadatos de la dirección
- E301 - No se reconoce el formato PDF
- E302 - Violación del área restringida de DVF
- E303 - Tamaño máximo de archivo de 20 MB excedido
- E304 - Número máximo de páginas de 94 excedido
- E305 - Código de país inválido
- E306 - Formato de dirección del destinatario inválido
- E307 - La primera página está en formato horizontal
- E308 - Se detectó un formato no DIN A4
- E309 - Nombre de archivo duplicado detectado
- E311 - Combinación inválida: Carta certificada y envío internacional
- E312 - Combinación inválida: Dúplex + Carta certificada
- E313 - Violación del esquema de la carta
- E314 - El tamaño del archivo de la página de portada supera 1 MB
- E315 - Error de procesamiento en el envío
- E316 - Error de carga
- E317 - Formato de carta certificada inválido
- E318 - Rechazo en el centro de impresión
- E319 - EKP no aprobado para el centro de impresión – Envío en vivo no posible
- E320 - Se alcanzó el número máximo de envíos de prueba por día
- E322 - Frecuencia de solicitud de estado demasiado alta – Mínimo 5 segundos entre solicitudes
- E323 - No se detectó contenido en el área del destinatario (página en blanco)
- E333 - Dirección del remitente ausente en el documento.
- E399 - Error general
- E501 - Estado de la API: Inactiva
- E601 - Error de plugin
- E900 - Error no especificado
Advertencias: Pueden requerir acción, pero el procesamiento continúa
- W101 - Advertencias de conversión a PDF/A
- W201 - Área de dirección excedida
- W202 - Área restringida izquierda excedida (se blanqueará)
- W203 - Desviaciones en los metadatos de dirección
- W220 - Desde el 01.10.2022, los detalles de la dirección del acuse de recibo se extraen automáticamente del área visible del remitente en la carta
- W301 - Falta la dirección del remitente (a partir del 1 de julio de 2025, la ausencia de la dirección del remitente en los documentos presentados se considerará un error («E333»)).
- W501 - Estado de la API: Aviso de mantenimiento
- W601 - Advertencia de plugin
Mensajes informativos: No requieren acción
- I101 - Opción adicional: Conversión de PDF a PDF/A
- I501 - Estado de la API: OK
- I601 - Información del plugin
- I701 - Actualización del estado de rastreo y localización
- I751 - Mensaje de estado para la región de destino
Registro de la cola para entradas de E-Post
El Document Dispatch -Registro de la cola rastrea eventos relacionados con cada tipo de envío, pero para las entradas de E-Post, el registro proporciona un historial detallado de las acciones de envío e incluye entradas como:
- Cuando una carta de E-Post fue enviada con éxito.
- Si una carta fue enviada en modo de prueba.
- Cualquier error del sistema o fallo que haya ocurrido durante el proceso de envío.
Los usuarios pueden revisar los registros de la cola dentro de la Cola de Document Dispatch con la acción Ver Registro, permitiéndoles monitorear actividades de envío y diagnosticar posibles problemas.
Registro de E-Post
El Registro de E-Post proporciona una auditoría detallada de las acciones del sistema relacionadas con E-Post, incluyendo:
- Intentos de inicio de sesión: Intentos de autenticación exitosos y fallidos.
- Cambios de contraseña: Registro de cambios de contraseña para el usuario de la API de E-POSTBUSINESS.
- Intentos de solicitud de código SMS: Cuando un nuevo código SMS fue solicitado con éxito o falló en la autenticación.
El registro de E-Post permite a los administradores rastrear cambios y garantizar la seguridad de la API de E-POSTBUSINESS.
Uso del Configurador Automático de Direcciones
El Configurador Automático de Direcciones ayuda a garantizar que las direcciones de los destinatarios estén posicionadas correctamente para el envío de cartas a través de E-Post.
Pasos para usar el Configurador Automático de Direcciones:
- Accede, por ejemplo, a una factura de venta contabilizada en Business Central.
- Selecciona un registro y elige la acción Enviar E-Post en el factbox de Document Dispatch.
- Asegúrate de que una configuración de superposición de direcciones ha sido establecida y activada.
- Al generar una factura para el envío a través de E-Post, el sistema aplicará automáticamente la superposición de dirección preconfigurada.
- Revisa la vista previa del documento para verificar que la superposición de dirección fue aplicada correctamente.
- Confirma el envío seleccionando la acción Ok.