{
"opencollection": "1.0.0",
"info": {
"name": "Logistics Cost Management HTTP API",
"version": "2.0"
},
"request": {
"auth": {
"type": "apikey",
"key": "X-XNSG_WEB_TOKEN",
"value": "{{X-XNSG_WEB_TOKEN}}",
"placement": "header"
}
},
"items": [
{
"info": {
"name": "BillingScenario",
"type": "folder"
},
"items": [
{
"info": {
"name": "getBillingScenario",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://rz3.aeb.de/demo1billing/rest/billing-scenarios/:id",
"params": [
{
"name": "id",
"value": "001",
"type": "path",
"description": "The requested ID of the billing scenario."
}
]
},
"docs": "Returns the billing scenario with the requested ID"
},
{
"info": {
"name": "searchScenarios",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://rz3.aeb.de/demo1billing/rest/billing-scenarios",
"params": [
{
"name": "ident_code_like",
"value": "*0*",
"type": "query",
"description": "Filters billing scenarios by ident code.
In the example, all scenarios which include '0' are returned.
This filter field is case insensitive.
Place holders are supported. The ident code is unique."
},
{
"name": "description_code_like",
"value": "*A*",
"type": "query",
"description": "Filters billing scenarios by description.
In the example, all scenarios which include 'A' in the description are returned.
This filter field is case insensitive.
Place holders are supported."
}
]
},
"docs": "Returns all billing scenarios matching the given filter criteria. In case no scenario matches the given filter criteria, an empty collection is returned. If the filter field supports place holders ('*' or '%'), all scenarios beginning with the value of the filter are returned. I.e. a place holder at the end of the filter value is added automatically."
}
]
},
{
"info": {
"name": "Service",
"type": "folder"
},
"items": [
{
"info": {
"name": "getService",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://rz3.aeb.de/demo1billing/rest/billing-scenarios/:id/services/:service-id",
"params": [
{
"name": "id",
"value": "001",
"type": "path",
"description": "The requested ID of the billing scenario."
},
{
"name": "service-id",
"value": "UPS_EXPR",
"type": "path",
"description": "The requested ID of the service."
}
]
},
"docs": "Returns the service of the billing scenario with the requested ID"
},
{
"info": {
"name": "createOrUpdateService",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://rz3.aeb.de/demo1billing/rest/billing-scenarios/:id/services/:service-id",
"params": [
{
"name": "id",
"value": "001",
"type": "path",
"description": "The requested ID of the billing scenario."
},
{
"name": "service-id",
"value": "UPS_EXPR",
"type": "path",
"description": "The requested ID of the service."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create or update a service in a billing scenario with the requested ID. If the service with the given ID does not exist, a new service is created. If the service exists, the existing service is fully updated. Not filled fields in the request are treated thereby as empty data fields and lead to empty fields in an existing service. It is therefore recommended to use GET/billing-scenarios/{id}/services to check whether a service with an ID already exists BEFORE you use PUT/billing-scenarios/{id}/se"
},
{
"info": {
"name": "deleteService",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://rz3.aeb.de/demo1billing/rest/billing-scenarios/:id/services/:service-id",
"params": [
{
"name": "id",
"value": "001",
"type": "path",
"description": "The requested ID of the billing scenario."
},
{
"name": "service-id",
"value": "UPS_EXPR",
"type": "path",
"description": "The requested ID of the service."
}
]
},
"docs": "Deletes a service in a billing scenario with the requested ID."
},
{
"info": {
"name": "searchServices",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://rz3.aeb.de/demo1billing/rest/billing-scenarios/:id/services",
"params": [
{
"name": "id",
"value": "001",
"type": "path",
"description": "The requested ID of the billing scenario."
},
{
"name": "ident_code_like",
"value": "*UPS*",
"type": "query",
"description": "Filter services by ident code.
In the example, all services which include 'UPS' are returned.
This filter field is case insensitive.
Place holders are supported. The ident code is unique for one billing scenario."
},
{
"name": "description_like",
"value": "*UPS*",
"type": "query",
"description": "Filter services by description.
In the example, all services which include 'UPS' in the description are returned.
This filter field is case insensitive.
Place holders are supported."
},
{
"name": "attribute_like",
"value": "*A*",
"type": "query",
"description": "Filter services by attribute.
In the example, all services which include 'A' in the attribute are returned.
This filter field is case insensitive.
Place holders are supported."
},
{
"name": "offset",
"value": "0",
"type": "query",
"description": "The starting point from which to return elements of the ordered list.
Minimum : 0"
},
{
"name": "limit",
"value": "200",
"type": "query",
"description": "The maximum number of elements to be returned from the ordered list.
Minimum : 1
Maximum : 1000"
}
]
},
"docs": "Returns all services of a billing scenario matching the given filter criteria. In case no service matches the given filter criteria, an empty collection is returned. If the filter field supports place holders ('*' or '%'), all scenarios beginning with the value of the filter are returned. I.e. a place holder at the end of the filter value is added automatically."
}
]
},
{
"info": {
"name": "Settlement",
"type": "folder"
},
"items": [
{
"info": {
"name": "get settlement",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://rz3.aeb.de/demo1billing/rest/settlements/:id",
"params": [
{
"name": "id",
"value": "000001",
"type": "path",
"description": "The Settlementnumber of the requested Settlement."
}
]
},
"docs": "Returns the settlement with the requested ID"
},
{
"info": {
"name": "Search settlements",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://rz3.aeb.de/demo1billing/rest/settlements",
"params": [
{
"name": "settlement_number_like",
"value": "000001",
"type": "query",
"description": "Filter settlements by Settlementnumber. Place holders are supported."
},
{
"name": "settlement_type_like",
"value": "Storno",
"type": "query",
"description": "Filter settlements by Settlementtype. Place holders are supported."
},
{
"name": "billing_scenario_like",
"value": "CAI",
"type": "query",
"description": "Filter settlements by Billingscenario. Place holders are supported."
},
{
"name": "provider_like",
"value": "UPS",
"type": "query",
"description": "Filter settlements by Provider companyNo. Place holders are supported."
},
{
"name": "status_list",
"value": "READY,COMPILED",
"type": "query",
"description": "Filter settlements by status code. Possible Status Codes are: READY, COMPILED, RELEASED, COMPLETE, CANCELLED Place holders are supported."
},
{
"name": "offset",
"value": "0",
"type": "query",
"description": "The starting point from which to return elements of the ordered list.
Minimum : 0"
},
{
"name": "limit",
"value": "200",
"type": "query",
"description": "The maximum number of elements to be returned from the ordered list.
Minimum : 1
Maximum : 1000"
}
]
},
"docs": "Returns all settlements matching the given filter criteria. In case no settlement matches, an empty collection is returned. Supports wildcards in filter fields."
}
]
},
{
"info": {
"name": "SettlementItem",
"type": "folder"
},
"items": [
{
"info": {
"name": "Search settlements",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://rz3.aeb.de/demo1billing/rest/settlements/:id/settlement-items",
"params": [
{
"name": "id",
"value": "000001",
"type": "path",
"description": "The Settlementnumber of the requested Settlement."
},
{
"name": "offset",
"value": "0",
"type": "query",
"description": "The starting point from which to return elements of the ordered list.
Minimum : 0"
},
{
"name": "limit",
"value": "200",
"type": "query",
"description": "The maximum number of elements to be returned from the ordered list.
Minimum : 1
Maximum : 1000"
}
]
},
"docs": "Returns all settlement items matching the given filter criteria. In case no settlement items matches, an empty collection is returned. Supports wildcards in filter fields."
}
]
},
{
"info": {
"name": "Billing",
"type": "folder"
},
"items": [
{
"info": {
"name": "acknowledgeChangedSettlements",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://rz3.aeb.de/demo1billing/rest/BillingBFBean/acknowledgeChangedSettlements",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "basic",
"username": "{{username}}",
"password": "{{password}}"
}
},
"docs": "Acknowledge that changed settlements were processed and should no longer be returned by getChangedSettlements."
},
{
"info": {
"name": "cancelServiceItems",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://rz3.aeb.de/demo1billing/rest/BillingBFBean/cancelServiceItems",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "basic",
"username": "{{username}}",
"password": "{{password}}"
}
},
"docs": "Cancel the service items in the Billing engine.
Cancel a service item will try to logically remove the service item with all of its settelement items, if this is possible.
In some cases the cancellation of service items is not (or no longer) possible and will lead to errors.
E.g. the service item can not be found, or some of the settlement items of the service item can not or no longer be logically removed.
The processing of all items will be done in one transaction, so in case o"
},
{
"info": {
"name": "createServiceItems",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://rz3.aeb.de/demo1billing/rest/BillingBFBean/createServiceItems",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "basic",
"username": "{{username}}",
"password": "{{password}}"
}
},
"docs": "Creates one or more service items. For each BServiceItemDTO included in the BCreateServiceItemsRequestDTO one service item is created. Starts pricing if boolean calculatePriceImmediately in BCreateServiceItemParmsDTO is true and returns the calculated prices. Use this method if you want to invoice and or audit the service items."
},
{
"info": {
"name": "getBillingScenarios",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://rz3.aeb.de/demo1billing/rest/BillingBFBean/getBillingScenarios",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "basic",
"username": "{{username}}",
"password": "{{password}}"
}
},
"docs": "Returns all billing scenarios for the given client"
},
{
"info": {
"name": "getBillingServices",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://rz3.aeb.de/demo1billing/rest/BillingBFBean/getBillingServices",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "basic",
"username": "{{username}}",
"password": "{{password}}"
}
},
"docs": "Returns all billing services for the given client and billing scenario as optional parameter."
},
{
"info": {
"name": "getChangedSettlements",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://rz3.aeb.de/demo1billing/rest/BillingBFBean/getChangedSettlements",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "basic",
"username": "{{username}}",
"password": "{{password}}"
}
},
"docs": "
Returns all changed settlements.
This method should be used together with acknowledgeChangedSettlements.
See also BGetChangedSettlementsResponseDTO#syncId" }, { "info": { "name": "getServiceItems", "type": "http" }, "http": { "method": "POST", "url": "https://rz3.aeb.de/demo1billing/rest/BillingBFBean/getServiceItems", "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Returns all service items for the given client." }, { "info": { "name": "offsetServiceItems", "type": "http" }, "http": { "method": "POST", "url": "https://rz3.aeb.de/demo1billing/rest/BillingBFBean/offsetServiceItems", "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Offset the service items in the Billing engine.Returns all changed external invoices.
This method should be used together with acknowledgeChangedExternalInvoices.
See also BGetChangedExternalInvoicesResponseDTO#syncId" } ] }, { "info": { "name": "Logon", "type": "folder" }, "items": [ { "info": { "name": "authToken", "type": "http" }, "http": { "method": "GET", "url": "https://rz3.aeb.de/demo1billing/rest/logon/authToken" }, "docs": "Logon from the \"Authorization\" header (e.g. type \"Basic\"). The generated authentication token can be used in subsequent calls in the \"Authorization\" header, type \"Bearer\"." }, { "info": { "name": "logonUser", "type": "http" }, "http": { "method": "POST", "url": "https://rz3.aeb.de/demo1billing/rest/logon/user", "body": { "type": "json", "data": "{}" } }, "docs": "Logon with classical procedure: user, client and password." } ] }, { "info": { "name": "DataFeedBFBean", "type": "folder" }, "items": [ { "info": { "name": "acknowledgePublishedDataFeedParts", "type": "http" }, "http": { "method": "POST", "url": "https://rz3.aeb.de/demo1billing/rest/DataFeedBFBean/acknowledgePublishedDataFeedParts", "body": { "type": "json", "data": "{}" } }, "docs": "Acknowledge the processed published data feed parts retrieved with getPublishedDataFeedParts containing the synchronization ID up to which all parts are acknowledged." }, { "info": { "name": "getDataFeedPartContentForRest", "type": "http" }, "http": { "method": "GET", "url": "https://rz3.aeb.de/demo1billing/rest/DataFeedBFBean/dataFeedParts/:client/:id", "params": [ { "name": "client", "value": "", "type": "path" }, { "name": "id", "value": "", "type": "path" } ] }, "docs": "Retrieve the data feed part content." }, { "info": { "name": "getPublishedDataFeedParts", "type": "http" }, "http": { "method": "POST", "url": "https://rz3.aeb.de/demo1billing/rest/DataFeedBFBean/getPublishedDataFeedParts", "body": { "type": "json", "data": "{}" } }, "docs": "Poll data about the next 10 published data feed parts. This data contains an id, which can be used to download the content of a part. To download the content, use the endpoint /DataFeedBFBean/dataFeedParts/{client}/{id} " } ] }, { "info": { "name": "Companies", "type": "folder" }, "items": [ { "info": { "name": "getCompany", "type": "http" }, "http": { "method": "GET", "url": "https://rz3.aeb.de/demo1billing/rest/companies/:id", "params": [ { "name": "id", "value": "12345", "type": "path", "description": "The requested ID (company number)." } ] }, "docs": "Returns the company with the requested ID (company number). In some cases the ID (company number) is not unique. In this case an error is returned." }, { "info": { "name": "createOrUpdateCompany", "type": "http" }, "http": { "method": "PUT", "url": "https://rz3.aeb.de/demo1billing/rest/companies/:id", "params": [ { "name": "id", "value": "12345", "type": "path", "description": "The requested ID (company number)." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Create or update a company with the specified ID (company number). If the company with the given ID does not exist, a new company is created. If the company exist, the existing company is fully updated. Not filled fields in the request are treated thereby as empty data fields and lead to empty fields in an already existing company. It is therefore recommended to use the GET/companies to check whether a company with a specific ID exists or not BEFORE you use PUT/companies/{id}." }, { "info": { "name": "deleteCompany", "type": "http" }, "http": { "method": "DELETE", "url": "https://rz3.aeb.de/demo1billing/rest/companies/:id", "params": [ { "name": "id", "value": "12345", "type": "path", "description": "The requested ID (company number)." } ] }, "docs": "Delete the company with the specified ID (company number). The ID is in some AEB services not unique, in this case a conflict (409) is returned." }, { "info": { "name": "searchCompanies", "type": "http" }, "http": { "method": "GET", "url": "https://rz3.aeb.de/demo1billing/rest/companies", "params": [ { "name": "is_enabled", "value": "false", "type": "query", "description": "Use this filter field with value 'true' if you want to get enabled companies only." }, { "name": "roles", "value": "", "type": "query", "description": "Filters companies by company roles. Use the API method GET/company-roles to retrieve all company roles. When searching for more than one role, all companies including one of the given roles are returned.