March 19th, 2025

Connect

Connect Public Documentation

APRIL 2025 | API Changelog 1.1.1

New IP Range for Improved Network Performance

To support continued reliability and connectivity, ecosio has expanded its infrastructure with the following new IP range:

45.91.254.0/23

This update helps ensure stable service and increased resilience across our network.

Action required: Please add this new range to your existing IP whitelist to avoid disruption.

If you need help updating your configuration, our support team is happy to assist.


Documents Endpoint Enhancements

View full endpoint documentation

https://connect.ecosio.com/reference/get_api-v1-documents-messageid#/

We’ve made several improvements to enhance document clarity, consistency, and data availability:

  • PDF Naming Standardisation

    • ecosio-generated PDFs now follow the format
      <id>_generated.pdf

    • Government-provided PDFs follow these conventions:

      • Inbound (AP): <id>_original.pdf

      • Outbound (AR): <id>_final.pdf

This update helps improve traceability and automation during file handling.

ZIP File Availability in Non-Final States

ZIP files can now be downloaded immediately after all necessary documents have been received, without needing to wait for final status. This enables faster processing and earlier access to document data.

Simplified Document Flow

  • Acknowledgements for inbound invoices (AP flow) have been removed for a cleaner document structure.

  • If the archive is unavailable, the endpoint now returns a 300 error instead of an empty ZIP file. This makes error handling more reliable and consistent.


Delivered Message Details Update

View message details documentation

We’ve added more detail to the documentation for the GET request to retrieve the details of a delivered message.

  • For e-invoice messages, use the includeAck parameter to receive the Acknowledgement directly within the same request.

  • As mentioned in our previous changelog, important IDs are available under externalReferences.

  • We've now added an overview of all existing external references to the documentation for even greater clarity.

This enhancement allows for more efficient tracking and integration of message-related data.


Archive Endpoint Update

View archive documentation

We’ve added support for retrieving PDFs directly via the Archive API.

  • Use the new includePDF parameter to include all available PDFs (both original and generated) in your archive ZIP file.

  • This means you can now download your document data and related PDFs in a single step, reducing friction in your retrieval process.

Example endpoint:

https://api.test.ecosio-hub.com:{port}/api/v1/archives

Stay in the Loop: Subscribe to the API Changelog

Never miss an update. Subscribe to our API changelog newsletter to receive notifications about feature enhancements, fixes, and important changes.

Get ahead of updates that could improve your integration and save your team time.