Enter your credentials to Maventa testing environment, to authenticate and try things out with the Swagger UI. This will fetch a Bearer token using OAuth2 with the endpoint POST https://ax-stage.maventa.com/oauth2/token. The token is stored in your browser's session storage (cleared when you close the tab) and used in Swagger calls done from this documentation website. The token is valid for 1 hour.

Never use your production credentials here. This is only for testing the Maventa test environment in the Swagger UI.
All | None
eui global company lookup document:receive document:send invoice:receive invoice:send company:read company:write validate receivables:assignments analysis billing:reports partner:invoice_delivery_actions partner:lookups partner:takeovers partner:lyanthe_scan_service fi_bank_message:send fi_bank_message:receive
Cancel Sign In
Search
Product Changelog Developer Changelog

Improved error messages for POST /v1/company/profiles

When calling POST /v1/company/profiles the parameters scheme and endpoint_id are optional, for example registering to Peppol can be done with this payload:

{
  "profiles": [
    "INVOICE_AND_CREDIT_NOTE"
  ],
  "network": "PEPPOL"
}

The scheme and endpoint_id will then be generated automatically based on the company’s bid and country.

However, if we could not generate them automatically, we previously would return a 400 Bad Request and a message that parameters scheme and endpoint_id were required. This error message was not very helpful since the parameters are not required for this request—there was something else wrong. A common case when this happens is in the staging environment where companies can be registered with an invalid bid format.

Now whenever automatic generation fails, the status code will be 422 Unprocessable Entity with a new error message

Could not auto-generate scheme and endpoint_id from company business id (COUNTRY BID). Provide both parameters explicitly using valid identifiers or ensure that your company is registered with a valid bid.

We expect this new error message will only appear in the staging environment and provide clearer guidance to integrators about what is wrong and how to fix it.

Published
Change Type
Changed
Tags
Swagger Links (swagger.maventa.com)
Back to top