v1

latestOpenAPI 3.1.02026-08-04103211436.0 KB
Logs

Create log

Reports a single execution event, warning or error observed by your integration while interacting with the Embat API, so Embat's support team can diagnose integration issues. Log delivery is best-effort: the endpoint returns 204 as soon as the request is accepted, and any failure while recording the log afterwards is not reported back to the caller.

post/logs/{companyId}

Path parameters

companyIdstring required

Request body

erp'netsuite' | 'sageX3' | 'odoo' | 'businessCentral' | 'navision' | 'libra' | 'distritoK' | 'fo' | 'zoho' | 'holded' | 'dynamicsAx' | 'a3' | 'businessOne' | 'openbravo' | 'sage200' | 'sage50' | 'r3' | 'ekon' | 'm3Rosetta' | 'sageIntacct' | 'datev' required
erpVersionstring required

Version of the ERP system that originated the log.

connectorVersionstring required

Version of the integration that reported the log.

level'INFO' | 'ERROR' | 'WARNING' required
code'INFO' | 'WARNING' | 'ERROR' | 'AUTHORIZATION_INFO' | 'AUTHORIZATION_WARNING' | 'AUTHORIZATION_ERROR' | 'ACCOUNTINGS_ACCOUNTS_INFO' | 'ACCOUNTINGS_ACCOUNTS_WARNING' | 'ACCOUNTINGS_ACCOUNTS_ERROR' | 'ACCOUNTINGS_ENTRIES_INFO' | 'ACCOUNTINGS_ENTRIES_WARNING' | 'ACCOUNTINGS_ENTRIES_ERROR' | 'ATTRIBUTES_INFO' | 'ATTRIBUTES_WARNING' | 'ATTRIBUTES_ERROR' | 'CONTACTS_INFO' | 'CONTACTS_WARNING' | 'CONTACTS_ERROR' | 'OPERATIONS_INFO' | 'OPERATIONS_WARNING' | 'OPERATIONS_ERROR' | 'PAYMENTS_INFO' | 'PAYMENTS_WARNING' | 'PAYMENTS_ERROR' required
messagestring required

Free-text description of the event, warning or error being reported.

Example request

{
  "erpVersion": "2024.1",
  "connectorVersion": "1.4.2",
  "message": "Failed to post payment: missing accounting account"
}

Response

Successful Response