{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Integrating Voxel for automated invoice collection","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrating-voxel-for-automated-invoice-collection","__idx":0},"children":["Integrating Voxel for automated invoice collection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this guide if you have an active Voxel account and want to enable automated invoice collection for accommodation bookings made via Demand API."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.voxelgroup.net/","target":"_blank","rel":"noopener"},"children":["Voxel"]}," is a third-party service provider that specialises in automating invoice collection on behalf of its clients. To support efficient invoicing for accommodation-related expenses, Booking.com has integrated its Demand API with Voxel’s invoicing platform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This integration allows invoices to be automatically generated and collected for accommodation bookings made via Demand API, simplifying the process for partners."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The integration supports both Demand API v2 and v3, with no breaking changes introduced. All existing functionality remains fully compatible for partners."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-features","__idx":2},"children":["Key features"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Seamless invoice collection"]}," - Corporate and non-corporate partners who book accommodations via Demand API can have their invoices automatically collected by Voxel."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["✅ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Backward compatibility"]}," - The integration is fully compatible with existing functionality, meaning no disruptions are expected for current partners."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"initial-setup-requirements","__idx":3},"children":["Initial setup requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To get started with the Voxel integration, make sure the following conditions are in place:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"35px"}},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A Voxel contract and an active Voxel account (as Voxel is an external service provider)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Notify your Booking.com Account Manager."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correct business information input during the order creation process."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"activation-requirements","__idx":4},"children":["Activation requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you can go live with the Voxel integration, the following conditions must be met:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"150px"}},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment method"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The use of either Online Payments or Payment Instructions is mandatory. Bookings using pay_at_the_property are not supported by the Voxel integration."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signed data-sharing agreement"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A signed addendum between you and Booking.com is required to authorise the transmission of invoice-related data to Voxel. Your Booking.com Account Manager can support you with this process."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agreed go-live date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A confirmed go-live date must be agreed between your organisation, Booking.com, and Voxel before activation of the integration."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-steps","__idx":5},"children":["Integration steps"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1---configure-business-information","__idx":6},"children":["Step 1 - Configure business information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To initiate the Voxel integration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Within the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["orders/create request"]},", include the following fields in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_information"]}," field:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["company name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["country (lowercase)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["VAT number"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["billing email."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Including this information ensures that all required details, such as the Tax ID, are provided to Voxel for invoice generation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"business_information\": {\n  \"company\": \"Company Name\",\n  \"billing\": {\n    \"address\": {\n      \"country\": \"nl\"\n    },\n    \"email\": \"your_company_email@example.com\",\n    \"vat\": \"VALID VAT NUMBER\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important: Validate the VAT Number "},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One of the most important aspects of using the Voxel integration is the validation of the VAT number."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Partners are responsible for providing a valid VAT number. Booking.com does not perform VAT validation."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the VAT number is invalid, invoice creation will fail. To avoid issues with invoicing, partners should carefully check the VAT number during the setup process."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend using the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.voxelgroup.net/src/taxid_validation.aspx","target":"_blank","rel":"noopener"},"children":["Voxel VAT validation tool"]}," to verify the number."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2---submit-reservations","__idx":7},"children":["Step 2 - Submit reservations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the business information has been submitted in your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["orders/create request"]},", Demand API will automatically push the reservation details to Voxel’s API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You will receive the order confirmation as usual."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/orders-api/order-preview-create"},"children":["orders/create guidelines"]}," for instructions on creating orders and best practices."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":8},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you encounter issues with the Voxel integration, consider the following troubleshooting steps:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"190px"}},"children":["Checklist"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validate VAT Number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure that the VAT number entered is correct."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invalid VAT numbers will cause the integration to fail, preventing reservation details from being pushed to Voxel."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Confirm business information"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Double-check that the business information provided during the reservation process is complete and accurate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Missing or incorrect details could cause invoicing errors."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review API responses"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the reservation creation fails, no invoice will be collected."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"//demand/docs/support/error-handling/payment-errors"},"children":["Payment error handling guide"]}," for more details."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"conclusion","__idx":9},"children":["Conclusion"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Voxel integration offers a streamlined process for all types of partners booking accommodations via Booking.com, enabling automatic invoice collection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure that your business details are accurate to make the most of the automated invoicing process."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Curious to know more?"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/orders-api/order-preview-create"},"children":["Orders guide"]}," for more tips and examples on how to preview and create your order requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/support/error-handling/payment-errors"},"children":["Payment errors guide"]}," for errors and examples."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-faqs"},"children":["Payment FAQs section"]}," for frequent questions and responses."]}]}]}]},"headings":[{"value":"Integrating Voxel for automated invoice collection","id":"integrating-voxel-for-automated-invoice-collection","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Key features","id":"key-features","depth":2},{"value":"Initial setup requirements","id":"initial-setup-requirements","depth":2},{"value":"Activation requirements","id":"activation-requirements","depth":2},{"value":"Integration steps","id":"integration-steps","depth":2},{"value":"Step 1 - Configure business information","id":"step-1---configure-business-information","depth":3},{"value":"Step 2 - Submit reservations","id":"step-2---submit-reservations","depth":3},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Conclusion","id":"conclusion","depth":2}],"frontmatter":{"seo":{"title":"Integrating Voxel for automated invoice collection"}},"lastModified":"2026-05-21T13:20:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/payments/models/voxel-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}