How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.
We are constantly improving and expanding our API. In order to give you the choice of when (or if) you want to benefit from these changes, we are versioning our API. Our API follows standard semantic versioning, which means we will introduce a new major version number in case new, backwards-incompatible changes are introduced to the Procuros API.The API version is included in the path of every endpoint. Example: https://api.procuros.io/v2/transactions (v2 shows this endpoint uses version 2)
Keep in mind, that purely additive changes are not considered backwards-incompatible, which means your system needs to
be able to handle new properties added to the JSON data returned by our API.
Use the version selector in the top lefthand corner of this page to adjust the API documentation to an older version.
For datetime attributes, we are using the ISO8601 format. However, we recommend sending datetime attributes using the Europe/Berlin timezone. Furthermore, all datetime attributes returned by our API will be in Europe/Berlin timezone, regardless of what timezone was used when storing the record.
You can use our Staging environment to test your interaction with the Procuros API, which protects you from accidentally sending transactions to your Trade Partners.Our Staging and Production environments can easily be distinguished by the domain.
Staging: https://api.procuros-staging.io/v2
Production: https://api.procuros.io/v2
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Procuros","colors":{"primary":"#0ED6A9","light":"#44EDC7","dark":"#08765D"},"logo":{"light":"https://mintcdn.com/procuros-c35f505c/UQJ4URaYQrt4VpDt/logo/procuros_light.svg?fit=max\u0026auto=format\u0026n=UQJ4URaYQrt4VpDt\u0026q=85\u0026s=8c0dbb848c9aaa3129931fa0960ca5ca","dark":"https://mintcdn.com/procuros-c35f505c/UQJ4URaYQrt4VpDt/logo/procuros_dark.svg?fit=max\u0026auto=format\u0026n=UQJ4URaYQrt4VpDt\u0026q=85\u0026s=60294f54596c1d4599756a22d70e73e6"},"favicon":"https://mintcdn.com/procuros-c35f505c/B4duGMjGkBbihGWc/favicon.png?fit=max\u0026auto=format\u0026n=B4duGMjGkBbihGWc\u0026q=85\u0026s=a7ffc55879607f2615243598f47bd0f8","background":{"color":{"light":"#ffffff","dark":"#000000"}},"navbar":{"links":[{"href":"https://portal.usepylon.com/procuros","label":"Support"}],"primary":{"type":"button","label":"Portal","href":"https://portal.procuros.io"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/procuros"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"en/general/welcome/introduction"},{"language":"de","href":"de/general/welcome/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"procuros-c35f505c","hasAudioNarration":false,"actualSubdomain":"procuros-c35f505c","customDomains":["docs.procuros.io"],"gitSource":{"type":"github","owner":"procuros","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5afbbcf5b122bc79bc1b2","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"en","tag":"API","count":54},{"language":"de","tag":"Connectors","count":40},{"language":"en","tag":"Connectors","count":40},{"language":"en","tag":"Documentation","count":34},{"language":"de","tag":"Dokumentation","count":31},{"language":"en","tag":"Documents","count":24},{"language":"en","tag":"Portal","count":21},{"language":"de","tag":"Portal","count":18},{"language":"de","tag":"Xentral","count":15},{"language":"en","tag":"Xentral","count":15},{"language":"de","tag":"Weclapp","count":13},{"language":"en","tag":"Guides","count":13},{"language":"en","tag":"Sending","count":13},{"language":"en","tag":"Weclapp","count":13},{"language":"en","tag":"Getting Started","count":12},{"language":"de","tag":"Dokumente Versenden","count":10},{"language":"de","tag":"Funktionalitäten","count":10},{"language":"de","tag":"Transaktionen","count":10},{"language":"de","tag":"MS Business Central","count":9},{"language":"de","tag":"Erste Schritte","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api/v2/api-concepts","slug":"/en/api/v2/api-concepts","pageMetadata":{"title":"Basics","description":"How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.","href":"/en/api/v2/api-concepts"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`api-versioning`,children:`API Versioning`}),`\n`,_jsxs(_components.p,{children:[`We are constantly improving and expanding our API. In order to give you the choice of when (or if) you want to benefit from these changes, we are versioning our API. Our API follows standard `,_jsx(_components.a,{href:`https://semver.org/`,children:`semantic versioning`}),`, which means we will introduce a new major version number in case new, backwards-incompatible changes are introduced to the Procuros API.`]}),`\n`,_jsxs(_components.p,{children:[`The API version is included in the path of every endpoint. Example: `,_jsx(_components.code,{children:`https://api.procuros.io/v2/transactions`}),` (`,_jsx(_components.code,{children:`v2`}),` shows this endpoint uses version 2)`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Keep in mind, that purely additive changes are not considered backwards-incompatible, which means your system needs to\nbe able to handle new properties added to the JSON data returned by our API.`})}),`\n`,_jsx(_components.p,{children:`Use the version selector in the top lefthand corner of this page to adjust the API documentation to an older version.`}),`\n`,_jsx(Heading,{level:`2`,id:`date-and-time`,children:`Date and Time`}),`\n`,_jsxs(_components.p,{children:[`For datetime attributes, we are using the ISO8601 format. However, we recommend sending datetime attributes using the `,_jsx(_components.code,{children:`Europe/Berlin`}),` timezone. Furthermore, `,_jsx(_components.strong,{children:`all`}),` datetime attributes returned by our API will be in `,_jsx(_components.code,{children:`Europe/Berlin`}),` timezone, regardless of what timezone was used when storing the record.`]}),`\n`,_jsx(Heading,{level:`2`,id:`testing`,children:`Testing`}),`\n`,_jsxs(_components.p,{children:[`You can use our `,_jsx(_components.strong,{children:`Staging environment`}),` to test your interaction with the Procuros API, which protects you from accidentally sending transactions to your Trade Partners.`]}),`\n`,_jsx(_components.p,{children:`Our Staging and Production environments can easily be distinguished by the domain.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Staging: `,_jsx(_components.code,{children:`https://api.procuros-staging.io/v2`})]}),`\n`,_jsxs(_components.li,{children:[`Production: `,_jsx(_components.code,{children:`https://api.procuros.io/v2`})]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Basics","description":"How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.","href":"/en/api/v2/api-concepts"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"API Versioning","slug":"api-versioning","depth":2,"children":[]},{"title":"Date and Time","slug":"date-and-time","depth":2,"children":[]},{"title":"Testing","slug":"testing","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"procuros-c35f505c","siteName":"Procuros","title":"Basics - Procuros","navMaps":{"firstHrefInVersion":{"v2":{"href":"/en/api/v2/api-concepts","matchLevel":0}},"firstHrefInLanguage":{"en":{"href":"/en/api/v2/api-concepts","matchLevel":0},"de":{"href":"/en/api/v2/api-concepts","matchLevel":0}}},"lastModified":"2026-11-09T09:58:19.980Z","originalFileLocation":"en/api/v2/api-concepts.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Procuros\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Basics - Procuros\">\u003cmeta data-mint-head property=\"og:description\" content=\"How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Procuros\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.procuros.io/en/api/v2/api-concepts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://procuros-c35f505c.mintlify.site/_mintlify/api/og/v2?division=API+Concepts\u0026amp;title=Basics\u0026amp;description=How+the+Procuros+API+handles+versioning+in+the+endpoint+path%2C+which+timezone+datetime+attributes+use%2C+and+how+to+test+safely+in+the+Staging+environment.\u0026amp;theme=f6fc9e6e2d76588c5200377b\u0026amp;signature=413effa80ef382c49011e2eeab7ca0b59210e0c41d482aa562fc2487f1bd7e1d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Basics - Procuros\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://procuros-c35f505c.mintlify.site/_mintlify/api/og/v2?division=API+Concepts\u0026amp;title=Basics\u0026amp;description=How+the+Procuros+API+handles+versioning+in+the+endpoint+path%2C+which+timezone+datetime+attributes+use%2C+and+how+to+test+safely+in+the+Staging+environment.\u0026amp;theme=f6fc9e6e2d76588c5200377b\u0026amp;signature=413effa80ef382c49011e2eeab7ca0b59210e0c41d482aa562fc2487f1bd7e1d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/procuros-c35f505c/4jYUXIqWEHnsFTWs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Procuros\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0ED6A9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.procuros.io/en/api/v2/api-concepts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api/v2/api-concepts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.procuros.io/#organization\",\"name\":\"Procuros\",\"url\":\"https://docs.procuros.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/procuros-c35f505c/UQJ4URaYQrt4VpDt/logo/procuros_light.svg?fit=max\u0026auto=format\u0026n=UQJ4URaYQrt4VpDt\u0026q=85\u0026s=8c0dbb848c9aaa3129931fa0960ca5ca\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.procuros.io#website\",\"name\":\"Procuros\",\"url\":\"https://docs.procuros.io\",\"publisher\":{\"@id\":\"https://docs.procuros.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.procuros.io/en/api/v2/api-concepts#webpage\",\"url\":\"https://docs.procuros.io/en/api/v2/api-concepts\",\"name\":\"Basics\",\"description\":\"How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.\",\"dateModified\":\"2026-11-09T09:58:19.980Z\",\"isPartOf\":{\"@id\":\"https://docs.procuros.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.procuros.io/en/api/v2/api-concepts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.procuros.io/en/api/v2/api-concepts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.procuros.io/en/api/v2/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Basics\",\"item\":\"https://docs.procuros.io/en/api/v2/api-concepts\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.procuros.io/en/api/v2/api-concepts#article\",\"headline\":\"Basics\",\"name\":\"Basics\",\"description\":\"How the Procuros API handles versioning in the endpoint path, which timezone datetime attributes use, and how to test safely in the Staging environment.\",\"url\":\"https://docs.procuros.io/en/api/v2/api-concepts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.procuros.io/en/api/v2/api-concepts#webpage\"},\"dateModified\":\"2026-11-09T09:58:19.980Z\",\"publisher\":{\"@id\":\"https://docs.procuros.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.procuros.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Procuros\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Procuros\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/api/v2/api-concepts.md","siteName":"Procuros","nav":{"global":null,"languages":[{"language":"en","anchors":[{"anchor":"Documentation","icon":"book-open-cover","pages":[{"title":"Documentation","href":"/en/general/welcome/introduction"}]},{"anchor":"Connectors","icon":"plug","pages":[{"title":"Connectors","href":"/en/connectors/as2/as2"}]},{"anchor":"API","icon":"rectangle-terminal","versions":[{"version":"v2","groups":[{"group":"Getting Started","pages":[{"title":"Overview","href":"/en/api/v2/overview"},{"title":"Quick Start","description":"Connect to the Procuros API with a bearer token, list incoming transactions filtered by document type, and send an order, with PHP examples using Guzzle.","href":"/en/api/v2/quick-start"},{"group":"API Concepts","pages":[{"title":"Basics","href":"/en/api/v2/api-concepts"},{"title":"Authentication","description":"Authenticate Procuros API requests with an API token sent as a bearer token in the Authorization header, test your connection, and use HTTPS only.","href":"/en/api/v2/concept-authentication"},{"title":"Pagination","href":"/en/api/v2/concept-pagination"},{"title":"Error Handling","href":"/en/api/v2/concept-error-handling"}]}]},{"group":"Endpoints","pages":[{"group":"Incoming Transactions","pages":[{"title":"List Incoming Transactions","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/transactions","href":"/en/api/v2/incoming-transactions/list-incoming-transactions"},{"title":"Mark Transaction Processed","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml put /v2/transactions/{procurosTransactionId}","href":"/en/api/v2/incoming-transactions/mark-transaction-processed"},{"title":"Bulk Mark Transactions Processed","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml post /v2/transactions/bulk/mark-processed","href":"/en/api/v2/incoming-transactions/bulk-mark-transactions-processed"}]},{"group":"Outgoing Transactions","pages":[{"title":"Send Transaction","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml post /v2/transactions","href":"/en/api/v2/outgoing-transactions/send-transaction"},{"title":"Report Outgoing Error","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml post /v2/errors","href":"/en/api/v2/outgoing-transactions/report-outgoing-error"}]},{"group":"All Transactions","pages":[{"title":"List All Transactions","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/all-transactions","href":"/en/api/v2/all-transactions/list-all-transactions"},{"title":"Show Transaction","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/all-transactions/{procurosTransactionId}","href":"/en/api/v2/all-transactions/show-transaction"}]},{"group":"Transport Labels","pages":[{"title":"Download Transport Label","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/transactions/{transportLabelUrl}/download","href":"/en/api/v2/transport-labels/download-transport-label"}]},{"group":"E-Invoicing","pages":[{"title":"Download Original File","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/transactions/{procurosTransactionId}/original-file","href":"/en/api/v2/e-invoicing/download-original-file"}]},{"group":"Misc","pages":[{"title":"Test connection to API","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/ping","href":"/en/api/v2/misc/test-connection-to-api"}]}]},{"group":"Documents","pages":[{"group":"Receiving","pages":[{"title":"Product Catalogs","href":"/en/api/v2/receiving-product-catalogs"},{"title":"Orders","href":"/en/api/v2/receiving-orders"},{"title":"Order Responses","href":"/en/api/v2/receiving-order-responses"},{"title":"Shipping Notices","href":"/en/api/v2/receiving-shipping-notices"},{"title":"Dispatch Instructions","href":"/en/api/v2/receiving-dispatch-instructions"},{"title":"Dispatch Instruction Responses","href":"/en/api/v2/receiving-dispatch-instruction-responses"},{"title":"Invoices","href":"/en/api/v2/receiving-invoices"},{"title":"Credit Notes","href":"/en/api/v2/receiving-credit-notes"},{"title":"Sales Reports","href":"/en/api/v2/receiving-sales-report"},{"title":"Work Orders","href":"/en/api/v2/receiving-work-orders"},{"title":"Stock Movements","href":"/en/api/v2/receiving-stock-movements"}]},{"group":"Sending","pages":[{"title":"Product Catalogs","href":"/en/api/v2/sending-product-catalogs"},{"title":"Orders","href":"/en/api/v2/sending-orders"},{"title":"Order Responses","href":"/en/api/v2/sending-order-responses"},{"title":"Shipping Notices","href":"/en/api/v2/sending-shipping-notices"},{"title":"Dispatch Instructions","href":"/en/api/v2/sending-dispatch-instructions"},{"title":"Dispatch Instruction Responses","href":"/en/api/v2/sending-dispatch-instruction-responses"},{"title":"Receival Notices","href":"/en/api/v2/sending-receival-notices"},{"title":"Invoices","href":"/en/api/v2/sending-invoices"},{"title":"Credit Notes","href":"/en/api/v2/sending-credit-notes"},{"title":"Inventory Reports","href":"/en/api/v2/sending-inventory-reports"},{"title":"Sales Reports","href":"/en/api/v2/sending-sales-report"},{"title":"Work Orders","href":"/en/api/v2/sending-work-orders"},{"title":"Stock Movements","href":"/en/api/v2/sending-stock-movements"}]}]},{"group":"Guides","pages":[{"group":"Testing","pages":[{"title":"Best Practices","href":"/en/api/v2/test-cases-overview"},{"title":"Test Data: Address Identifiers","href":"/en/api/v2/test-cases-address-identifiers"},{"title":"Test Data: Items","href":"/en/api/v2/test-cases-items"}]},{"title":"Product Identification","href":"/en/api/v2/features-product-identification"},{"title":"Enabled Trade Partners","href":"/en/api/v2/features-enabled-trade-partners"},{"title":"Tracking Document Status","href":"/en/api/v2/features-tracking-document-status"},{"title":"Package Identification","href":"/en/api/v2/features-package-identification"},{"title":"Bottle Deposits","href":"/en/api/v2/features-bottle-deposits"},{"title":"Taxes (VAT)","href":"/en/api/v2/features-taxes-vat"},{"title":"Batches \u0026 Best Before Dates","href":"/en/api/v2/features-batches-best-before-dates"},{"title":"Invoice Modifications","href":"/en/api/v2/features-invoice-modifications"},{"title":"Trade Partner + Party Identification","href":"/en/api/v2/features-trade-partner-party-identification"},{"title":"Document Versioning","href":"/en/api/v2/features-document-versioning"}]},{"group":"Other","pages":[{"title":"Changelog","href":"/en/api/v2/changelog"}]}]}]}]},{"language":"de","anchors":[{"anchor":"Dokumentation","icon":"book-open-cover","pages":[{"title":"Dokumentation","href":"/de/general/welcome/introduction"}]},{"anchor":"Connectors","icon":"plug","pages":[{"title":"Connectors","href":"/de/connectors/as2/as2"}]},{"anchor":"API Referenz","icon":"rectangle-terminal","versions":[{"version":"v2","groups":[{"group":"Getting Started","pages":[{"title":"Overview","href":"/en/api/v2/overview"},{"title":"Quick Start","description":"Connect to the Procuros API with a bearer token, list incoming transactions filtered by document type, and send an order, with PHP examples using Guzzle.","href":"/en/api/v2/quick-start"},{"group":"API Concepts","pages":[{"title":"Basics","href":"/en/api/v2/api-concepts"},{"title":"Authentication","description":"Authenticate Procuros API requests with an API token sent as a bearer token in the Authorization header, test your connection, and use HTTPS only.","href":"/en/api/v2/concept-authentication"},{"title":"Pagination","href":"/en/api/v2/concept-pagination"},{"title":"Error Handling","href":"/en/api/v2/concept-error-handling"}]}]},{"group":"Documents","pages":[{"group":"Receiving","pages":[{"title":"Product Catalogs","href":"/en/api/v2/receiving-product-catalogs"},{"title":"Orders","href":"/en/api/v2/receiving-orders"},{"title":"Order Responses","href":"/en/api/v2/receiving-order-responses"},{"title":"Shipping Notices","href":"/en/api/v2/receiving-shipping-notices"},{"title":"Dispatch Instructions","href":"/en/api/v2/receiving-dispatch-instructions"},{"title":"Dispatch Instruction Responses","href":"/en/api/v2/receiving-dispatch-instruction-responses"},{"title":"Invoices","href":"/en/api/v2/receiving-invoices"},{"title":"Credit Notes","href":"/en/api/v2/receiving-credit-notes"},{"title":"Work Orders","href":"/en/api/v2/receiving-work-orders"},{"title":"Stock Movements","href":"/en/api/v2/receiving-stock-movements"}]},{"group":"Sending","pages":[{"title":"Product Catalogs","href":"/en/api/v2/sending-product-catalogs"},{"title":"Orders","href":"/en/api/v2/sending-orders"},{"title":"Order Responses","href":"/en/api/v2/sending-order-responses"},{"title":"Shipping Notices","href":"/en/api/v2/sending-shipping-notices"},{"title":"Dispatch Instructions","href":"/en/api/v2/sending-dispatch-instructions"},{"title":"Dispatch Instruction Responses","href":"/en/api/v2/sending-dispatch-instruction-responses"},{"title":"Receival Notices","href":"/en/api/v2/sending-receival-notices"},{"title":"Invoices","href":"/en/api/v2/sending-invoices"},{"title":"Credit Notes","href":"/en/api/v2/sending-credit-notes"},{"title":"Inventory Reports","href":"/en/api/v2/sending-inventory-reports"},{"title":"Work Orders","href":"/en/api/v2/sending-work-orders"},{"title":"Stock Movements","href":"/en/api/v2/sending-stock-movements"}]}]},{"group":"Guides","pages":[{"group":"Testing","pages":[{"title":"Best Practices","href":"/en/api/v2/test-cases-overview"},{"title":"Test Data: Address Identifiers","href":"/en/api/v2/test-cases-address-identifiers"},{"title":"Test Data: Items","href":"/en/api/v2/test-cases-items"}]},{"title":"Product Identification","href":"/en/api/v2/features-product-identification"},{"title":"Enabled Trade Partners","href":"/en/api/v2/features-enabled-trade-partners"},{"title":"Tracking Document Status","href":"/en/api/v2/features-tracking-document-status"},{"title":"Package Identification","href":"/en/api/v2/features-package-identification"},{"title":"Bottle Deposits","href":"/en/api/v2/features-bottle-deposits"},{"title":"Taxes (VAT)","href":"/en/api/v2/features-taxes-vat"},{"title":"Batches \u0026 Best Before Dates","href":"/en/api/v2/features-batches-best-before-dates"},{"title":"Invoice Modifications","href":"/en/api/v2/features-invoice-modifications"},{"title":"Trade Partner + Party Identification","href":"/en/api/v2/features-trade-partner-party-identification"},{"title":"Document Versioning","href":"/en/api/v2/features-document-versioning"}]},{"group":"Changelog","pages":[{"title":"Changelog","href":"/en/api/v2/changelog"}]},{"group":"Endpoints","pages":[{"group":"Incoming Transactions","pages":[{"title":"List Incoming Transactions","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/transactions","href":"/en/api/v2/incoming-transactions/list-incoming-transactions"},{"title":"Mark Transaction Processed","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml put /v2/transactions/{procurosTransactionId}","href":"/en/api/v2/incoming-transactions/mark-transaction-processed"},{"title":"Bulk Mark Transactions Processed","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml post /v2/transactions/bulk/mark-processed","href":"/en/api/v2/incoming-transactions/bulk-mark-transactions-processed"}]},{"group":"Outgoing Transactions","pages":[{"title":"Send Transaction","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml post /v2/transactions","href":"/en/api/v2/outgoing-transactions/send-transaction"},{"title":"Report Outgoing Error","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml post /v2/errors","href":"/en/api/v2/outgoing-transactions/report-outgoing-error"}]},{"group":"All Transactions","pages":[{"title":"List All Transactions","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/all-transactions","href":"/en/api/v2/all-transactions/list-all-transactions"},{"title":"Show Transaction","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/all-transactions/{procurosTransactionId}","href":"/en/api/v2/all-transactions/show-transaction"}]},{"group":"Transport Labels","pages":[{"title":"Download Transport Label","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/transactions/{transportLabelUrl}/download","href":"/en/api/v2/transport-labels/download-transport-label"}]},{"group":"E-Invoicing","pages":[{"title":"Download Original File","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/transactions/{procurosTransactionId}/original-file","href":"/en/api/v2/e-invoicing/download-original-file"}]},{"group":"Misc","pages":[{"title":"Test connection to API","deprecated":null,"version":null,"openapi":"/en/api/v2/openapi-v2.yaml get /v2/ping","href":"/en/api/v2/misc/test-connection-to-api"}]}]}]}]}]}]},"basePath":"","title":"Basics - Procuros","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}