api:integration:economic:contacts
Table of Contents
API : Economic Customer Contact List
Introduction
E-conomic customer contacts are used as the reference on exported invoices. The endpoint lists the contacts of one e-conomic customer, read with the given reseller's e-conomic agreement.
Request
| URL | https://api.telecomx.dk/integration/economic/contacts/:accountingSystemId | |
|---|---|---|
| Method | GET | |
| Access level | RESELLER, RESELLER_ADMIN or ADMIN with read access to the reseller. | |
| Params | accountingSystemId | Number of the customer in e-conomic, digits only |
| Query | reseller | Id of the reseller whose e-conomic agreement is used |
Query examples
https://api.telecomx.dk/integration/economic/contacts/12345?reseller=650000000000000000000001
Response
An array of e-conomic customer contact objects, passed on as e-conomic returns them.
| Customer contact object | ||
|---|---|---|
| Property | Type | Description |
| customerContactNumber | Number | Unique ID of the customer contact |
| name | String | Name of the customer contact |
| customer.customerNumber | Number | Unique ID of the customer |
| customer.self | String | URL of the customer in e-conomic |
| self | String | URL of the customer contact in e-conomic |
Note that since this data is fetched from a third-party, the data returned can not be guaranteed.
Example - normal
[ { "customerContactNumber": 19, "name": "Bogholderi", "customer": { "customerNumber": 12345, "self": "https://restapi.e-conomic.com/customers/12345" }, "self": "https://restapi.e-conomic.com/customers/12345/contacts/19" }, { "customerContactNumber": 410, "name": "Direktion", "customer": { "customerNumber": 12345, "self": "https://restapi.e-conomic.com/customers/12345" }, "self": "https://restapi.e-conomic.com/customers/12345/contacts/410" } ]
Errors
| Error code | Message | Description |
|---|---|---|
| 422 | <property> | Invalid input for the named property - the request body, query or URL parameter failed validation |
| 403 | access_denied | Insufficient access level |
| 404 | id | Reseller not found |
| 404 | economic.agreementGrantToken | Not found |
| 401 | e-conomic rejected the reseller's agreement grant token. The body is e-conomic's own error, not the standard error object | |
| 404 | e-conomic has no customer with that number. The body is e-conomic's own error, not the standard error object | |
| 500 | internal_error | <Unspecified> |
api/integration/economic/contacts.txt · Last modified: by Mikkel Meerwaldt Jørgensen