Obtener facturas a través de la API SOAP legacy: GetInboxDocuments, GetInboxDocument, gestión de estados y descarga de PDF.
Con la API SOAP legacy, usted obtiene los documentos recibidos mediante polling. Verifica periódicamente si hay nuevos documentos en su bandeja de entrada, los descarga y actualiza el estado. Este artículo describe el flujo completo de recepción.
Importante: Esta es la API SOAP legacy. Para nuevas integraciones recomendamos la REST API. La REST API ofrece webhooks, por lo que no es necesario hacer polling.
Llame a GetInboxDocuments con el filtro CreatedOn.From para obtener solo los documentos nuevos. Después de cada llamada, guarde el valor más alto de CreatedOn y utilícelo como punto de partida para la siguiente consulta.
<GetInboxDocuments>
<Filter>
<CreatedOn>
<From>2026-03-01T00:00:00</From>
</CreatedOn>
</Filter>
</GetInboxDocuments>
La respuesta contiene metadata de todos los documentos en la bandeja de entrada. Filtre por Template/MasterId para seleccionar solo el tipo de documento correcto. Para facturas estándar utilice el MasterTemplateId:
GLDT9223370666504283001RA000000006DTP2000001
Utilice siempre el MasterTemplateId y no un ID específico de versión, ya que este no cambia con las actualizaciones de la plantilla.
Obtenga la carga útil completa por documento con GetInboxDocument, utilizando el ExternalId de la lista de metadata:
<GetInboxDocument>
<ExternalId>het-external-id-uit-stap-1</ExternalId>
</GetInboxDocument>
Utilice GetDocumentPdf para obtener la versión PDF del documento. El PDF se devuelve como una cadena codificada en base64.
Nota: si el PDF todavía se está generando, la API devuelve el código de error ERRDMN8000003. En ese caso, espere unos segundos e inténtelo de nuevo.
Actualice el estado del documento con SetInboxDocumentStatus. Esto es importante para el flujo de procesamiento y para la visibilidad del estado en la plataforma.
La bandeja de entrada tiene los siguientes códigos de estado. Utilice siempre el código (no el nombre) al filtrar y actualizar.
Al obtener documentos, puede utilizar diversos filtros para limitar los resultados:
ExternalIdCreatedOnModifiedOnSender / ReceiverTemplate/MasterIdStatusAdemás de los documentos de la bandeja de entrada, también puede consultar sus propios documentos enviados. Utilice para ello GetOutboxDocuments y GetOutboxDocument. El funcionamiento es similar al de los endpoints de inbox, pero para documentos que usted mismo ha enviado.
Para documentos que aún no han sido enviados (drafts), utilice GetDocuments y GetDocument. Estos endpoints funcionan con un DocumentId en lugar de un ExternalId. Los drafts tienen sus propios códigos de estado:
Intervalo: no haga polling con más frecuencia que una vez por minuto. Para la mayoría de las integraciones, una vez cada 5 a 15 minutos es suficiente.
Obtención incremental: guarde siempre el valor más alto de CreatedOn y utilícelo como filtro From en la siguiente llamada. De esta manera evitará obtener los mismos documentos repetidamente.
Detectar cambios de estado: utilice el filtro ModifiedOn si desea detectar cuándo ha cambiado el estado de documentos existentes, por ejemplo después de una aprobación o pago.
Con la REST API no es necesario hacer polling: los webhooks envían automáticamente una notificación cuando llega un nuevo documento. Consulte psb.econnect.eu para el enfoque moderno.
Migrar a la REST API