The Tinx Connector lets you send sales document PDFs, such as invoices, confirmations, or other customer documents, from Business Central to your webshop or sales platform using the Document field type in the message mapping.
This feature is commonly used by companies that sell school-related products or supplier goods, or that want to include formal documentation with order data sent back to the webshop.
The connector automatically converts the document to a base64-encoded string and sends it via a REST API call to the connected platform.
Platform compatibility
This functionality is available across multiple platforms, provided the endpoint accepts file content or base64-encoded data:
- WooCommerce: works with custom REST API endpoints that accept document fields.
- Shopify: file sharing is supported via the GraphQL staged upload API.
- Magento: supports document attachments via its REST API.
- Amazon Seller Central: file and document uploads are possible via the Selling Partner API.
Actual implementation depends on each platform's capabilities and your setup. The Tinx Connector provides the flexibility to configure this on a per-sales-channel basis.
To activate document sending
- Configure your message mapping to include a field of type Document.
- Make sure the PDF is generated and stored in Business Central in a supported way.
The connector encodes the document and includes it in the outbound message.
You need to have an endpoint on the webshop side to get the PDF data. The webshops need to be customized to receive the data. In the storylane, the purchase-orders/%1 endpoint indicated in the Webservice field on step 2 of the interactive walkthrough is an example of a custom endpoint.
Interactive walkthrough
The following interactive walkthrough demonstrates how to configure a message mapping field with the Document type, select the appropriate Document Output Type in the field setup, and use the Record ID value from the Webshop Order or Webshop Documents table to generate a base64-encoded PDF string in the outbound payload.
Related information
Sales channel
Synchronize orders
Key concepts in Tinx
Connector
Troubleshooting checklist
Questions or comments
If you have any questions or comments about this article or need further help, contact Support or write directly to us at docs@tinx-it.nl.
Last updated on April 7, 2025