{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Invoicing & Finance","description":"The operational transportation management API. Full access to planning, tracking, invoicing, and integrations — built on the OTM5 open data standard.","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":"invoicing--finance","__idx":0},"children":["Invoicing & Finance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transportial provides full invoicing and quoting capabilities tied to your transport operations. Generate invoices from transport orders, send quotes to customers, and manage the financial lifecycle."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"invoices","__idx":1},"children":["Invoices"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creating-an-invoice","__idx":2},"children":["Creating an Invoice"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/invoice \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Invoice #2026-042\",\n    \"direction\": \"OUT\",\n    \"date\": \"2026-03-22\",\n    \"subjectBusiness\": { \"id\": \"your-business-uuid\" },\n    \"targetBusiness\": { \"id\": \"customer-business-uuid\" },\n    \"lines\": [\n      {\n        \"description\": \"Transport Rotterdam → Amsterdam\",\n        \"quantity\": 1,\n        \"unitPrice\": 450.00,\n        \"taxPercentage\": 21\n      }\n    ]\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"invoice\": {\n    \"id\": \"invoice-uuid\",\n    \"number\": \"2026-042\",\n    \"status\": \"concept\",\n    \"direction\": \"OUT\",\n    \"subTotal\": 450.00,\n    \"tax\": 94.50,\n    \"total\": 544.50,\n    \"totalOpen\": 544.50,\n    \"currency\": \"EUR\",\n    \"createdAt\": \"2026-03-22T10:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sending-an-invoice","__idx":3},"children":["Sending an Invoice"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.otms.transportial.com/api/invoice/{id}/send\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This emails the invoice to the target business's contact email."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sending-a-payment-reminder","__idx":4},"children":["Sending a Payment Reminder"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.otms.transportial.com/api/invoice/{id}/send:reminder\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"invoice-from-email","__idx":5},"children":["Invoice from Email"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transportial can create invoices from incoming emails:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT \"https://api.otms.transportial.com/api/invoice/mail/receiver\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"from\": \"supplier@example.com\",\n    \"subject\": \"Invoice #INV-2026-100\",\n    \"body\": \"Please find attached invoice...\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"listing-invoices","__idx":6},"children":["Listing Invoices"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# List invoices for an administration (paginated)\ncurl -X GET \"https://api.otms.transportial.com/api/invoices/{administrationId}/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\n# Search invoices with filters\ncurl -X POST \"https://api.otms.transportial.com/api/invoices/{administrationId}/0/20\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"status\": \"sent\",\n    \"direction\": \"OUT\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quotes","__idx":7},"children":["Quotes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quotes provide pricing before a transport order is accepted. They can be sent to customers and converted to invoices."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creating-a-quote","__idx":8},"children":["Creating a Quote"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/quote \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Quote #Q-2026-015\",\n    \"direction\": \"OUT\",\n    \"date\": \"2026-03-22\",\n    \"dueAt\": \"2026-04-05T23:59:59Z\",\n    \"subjectBusiness\": { \"id\": \"your-business-uuid\" },\n    \"targetBusiness\": { \"id\": \"customer-business-uuid\" },\n    \"lines\": [\n      {\n        \"description\": \"Transport Rotterdam → Berlin (full truck)\",\n        \"quantity\": 1,\n        \"unitPrice\": 1200.00,\n        \"taxPercentage\": 21\n      }\n    ]\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sending-a-quote","__idx":9},"children":["Sending a Quote"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.otms.transportial.com/api/quote/{id}/send\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"public-quote-links","__idx":10},"children":["Public Quote Links"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quotes support shared links that allow recipients to accept or decline without logging in:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Recipient views the quote\nGET /api/quote:public/{id}/{shareCode}\n\n# Recipient accepts\nPOST /api/quote:public/{id}/accept/{shareCode}\n\n# Recipient declines\nPOST /api/quote:public/{id}/decline/{shareCode}\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"converting-a-quote-to-an-invoice","__idx":11},"children":["Converting a Quote to an Invoice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once accepted, convert a quote directly into an invoice:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.otms.transportial.com/api/quote/{id}/create:invoice\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"financial-fields-on-transport-entities","__idx":12},"children":["Financial Fields on Transport Entities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transport orders, consignments, and trips all carry financial fields:"]},{"$$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":"Entity"},"children":["Entity"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Fields"},"children":["Fields"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transport Order"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expectedRevenue"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expectedCost"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consignment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expectedRevenue"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expectedCost"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pricingElements"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Trip"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expectedRevenue"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expectedCost"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actualCost"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invoice"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subTotal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["totalOpen"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Quote"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subTotal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These fields allow you to track estimated vs. actual costs across the entire transport chain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"invoice-directions","__idx":13},"children":["Invoice Directions"]},{"$$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":"Direction"},"children":["Direction"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OUT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outgoing invoice — you are billing a customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incoming invoice — a supplier is billing you"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":14},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create transport orders first with the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/quickstart"},"children":["Quickstart guide"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn about the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/concepts"},"children":["entity hierarchy"]}," that drives financial data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the full ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis"},"children":["API Reference"]}," for all invoice and quote endpoints"]}]}]},"headings":[{"value":"Invoicing & Finance","id":"invoicing--finance","depth":1},{"value":"Invoices","id":"invoices","depth":2},{"value":"Creating an Invoice","id":"creating-an-invoice","depth":3},{"value":"Sending an Invoice","id":"sending-an-invoice","depth":3},{"value":"Sending a Payment Reminder","id":"sending-a-payment-reminder","depth":3},{"value":"Invoice from Email","id":"invoice-from-email","depth":3},{"value":"Listing Invoices","id":"listing-invoices","depth":3},{"value":"Quotes","id":"quotes","depth":2},{"value":"Creating a Quote","id":"creating-a-quote","depth":3},{"value":"Sending a Quote","id":"sending-a-quote","depth":3},{"value":"Public Quote Links","id":"public-quote-links","depth":3},{"value":"Converting a Quote to an Invoice","id":"converting-a-quote-to-an-invoice","depth":3},{"value":"Financial Fields on Transport Entities","id":"financial-fields-on-transport-entities","depth":2},{"value":"Invoice Directions","id":"invoice-directions","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Invoicing & Finance"}},"lastModified":"2026-03-22T20:40:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/invoicing-and-finance","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}