ProductoDesarrolladoresConocimiento
Plataforma Control
SOAP API: enviar facturas con SendDocument

Enviar facturas y documentos a través del endpoint SOAP SendDocument: parámetros, enrutamiento y seguimiento de estado.

Con el endpoint SendDocument de la API SOAP legacy, usted envía facturas y otros documentos a través de la plataforma eConnect. La plataforma determina automáticamente la mejor ruta: a través de la propia plataforma eConnect, a través de Peppol, o como alternativa por correo electrónico.

Importante: Esta es la API SOAP legacy. Para nuevas integraciones recomendamos la REST API.

Cómo funciona SendDocument

Al llamar a SendDocument, usted incluye el documento fuente junto con los datos del remitente y del destinatario. La plataforma busca al destinatario en tres pasos:

  1. Plataforma eConnect: ¿el destinatario también es usuario de la plataforma? Entonces el documento se entrega directamente en la bandeja de entrada.
  2. Peppol: ¿el destinatario es localizable en la red Peppol? Entonces el documento se enruta a través de Peppol.
  3. Correo electrónico (alternativa): si ninguna de las dos opciones anteriores es posible y se ha proporcionado una dirección de correo electrónico, el documento se envía por correo electrónico.
Parámetros obligatorios
ParámetroDescripciónVia/ReferenceIdIdentificación del remitente (su propio EConnectPartyId, número XCNL)To/ReferenceIdIdentificación del destinatario (EConnectPartyId o identificador Peppol como 0106:número-KVK)To/EmailAddressDirección de correo electrónico del destinatario (se utiliza como alternativa cuando el enrutamiento por plataforma y Peppol no es posible)SubjectAsunto del documentoPayloadEl documento en sí, como UBL-XML. Nota: envíe el XML sin prólogo XML (<?xml ...?>)TemplateIdEl ID de plantilla que indica el tipo de documento
Ejemplo de llamada
<SendDocument>
  <Document>
    <Via>
      <ReferenceId>XCNL-123456</ReferenceId>
    </Via>
    <To>
      <ReferenceId>0106:12345678</ReferenceId>
      <EmailAddress>[email protected]</EmailAddress>
    </To>
    <Subject>Factuur 2026-001</Subject>
    <Payload><!-- UBL-XML zonder prolog --></Payload>
    <TemplateId>GLDT9223370666504283001RA000000006DTP2000001</TemplateId>
  </Document>
</SendDocument>

El TemplateId GLDT9223370666504283001RA000000006DTP2000001 es el MasterTemplateId para una factura estándar. Utilice siempre el MasterTemplateId (no un código de versión), ya que este permanece estable entre versiones de la plantilla.

Response y ExternalId

Después de una llamada exitosa, la API devuelve un ExternalId. Este es el identificador único del documento enviado en la plataforma eConnect. Si la respuesta no contiene un ExternalId, el documento no ha sido enviado. En ese caso, verifique el mensaje de error en la respuesta.

Guarde siempre el ExternalId: lo necesitará para consultar el estado del documento posteriormente.

DeliveryMethod

La API también devuelve el DeliveryMethod en la respuesta, para que usted sepa a través de qué canal se entregó el documento:

ValorSignificadoToInboxEntregado en la bandeja de entrada del destinatario en la plataforma eConnectToPeppolEnviado a través de la red PeppolToEmailEnviado por correo electrónicoOutboxOnlySolo guardado en su propia bandeja de salida (no entregado)NoneNo fue posible la entrega
Seguimiento de estado

Después del envío, puede hacer seguimiento del estado de su documento con dos endpoints:

EndpointFunciónGetOutboxDocumentsObtener la lista de documentos enviados. Filtre por ModifiedOn para ver solo los documentos modificados recientemente.GetOutboxDocumentConsultar un documento específico basándose en el ExternalId.GetOutboxDocumentStatusConsultar solo el estado, sin el documento completo.
Consejos

UBL-XML sin prólogo: el Payload debe contener UBL-XML sin la declaración <?xml version="1.0" encoding="UTF-8"?>. Si incluye el prólogo, es posible que el documento no se procese correctamente.

Utilice MasterTemplateId: filtre siempre por Template/MasterId en lugar de por un ID de plantilla específico. El MasterTemplateId no cambia con las actualizaciones de versión de la plantilla.

Manejo de errores: verifique la respuesta en busca de códigos de error. Las series de códigos de error 400 (validación) y 200 (funcional) son las más frecuentes en errores de envío. Consulte la página de autenticación para la descripción general completa de las series de códigos de error.

La REST API ofrece capacidades adicionales para el envío, como webhooks para notificaciones de estado y reintento automático en caso de errores. Consulte psb.econnect.eu para el enfoque moderno.

Migrar a la REST API

Relacionado
PreviousSOAP autenticación
NextSOAP recibir