Create an e-invoicing connection | Monite Documentation

curl -X POST https://api.sandbox.monite.com/v1/einvoicing_connections \
     -H "x-monite-version: 2024-05-25" \
     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "address": {
    "address_line1": "address_line1",
    "city": "city",
    "country": "DE",
    "postal_code": "postal_code"
  }
}'

{
  "id": "id",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "address": {
    "address_line1": "address_line1",
    "city": "city",
    "country": "DE",
    "postal_code": "postal_code",
    "address_line2": "address_line2",
    "state": "state"
  },
  "credentials": [
    {
      "id": "id",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "einvoicing_connection_id": "einvoicing_connection_id",
      "network_credentials_identifier": "12345678",
      "network_credentials_schema": "DE:VAT"
    }
  ],
  "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "legal_name": "legal_name",
  "status": "active",
  "is_receiver": true,
  "is_sender": true,
  "provider_id": "12345"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-monite-versionstringRequired

x-monite-entity-idstringRequired

The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.

addressobjectRequired

Integration Address

entity_vat_id_idstringOptionalformat: "uuid"

Entity VAT ID identifier for the integration

is_receiverbooleanOptionalDefaults to true

Set to true if the entity needs to receive e-invoices.

is_senderbooleanOptionalDefaults to true

Set to true if the entity needs to send e-invoices. Either is_sender or is_receiver or both must be true.

Response

Successful Response

idstringformat: "uuid"

created_atdatetime

Date of Integration

updated_atdatetime

Last update of Integration

addressobject

Integration Address

credentialslist of objects

List of credentials

entity_idstringformat: "uuid"

ID of the entity

legal_namestring

Legal name of the Entity

statusstring

Current status of the integration

is_receiverbooleanDefaults to true

Set to true if the entity needs to receive e-invoices.

is_senderbooleanDefaults to true

Set to true if the entity needs to send e-invoices. Either is_sender or is_receiver or both must be true.

provider_idstring

ID assigned by integration partner

Errors

400

Post Einvoicing Connections Request Bad Request Error

401

Post Einvoicing Connections Request Unauthorized Error

403

Post Einvoicing Connections Request Forbidden Error

409

Post Einvoicing Connections Request Conflict Error

422

Post Einvoicing Connections Request Unprocessable Entity Error

429

Post Einvoicing Connections Request Too Many Requests Error