Get required field names for invoice creation

import requests
url = "https://api.sandbox.monite.com/v1/receivables/required_fields"
headers = {
    "x-monite-version": "2024-05-25",
    "x-monite-entity-id": "9d2b4c8f-2087-4738-ba91-7359683c49a4",
    "Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())

{
  "counterpart": {
    "tax_id": {
      "description": "The counterpart's taxpayer identification number or tax ID. For identification purposes, this field may be required for counterparts that are not VAT-registered.",
      "required": false
    },
    "vat_id": {
      "description": "The counterpart's VAT (Value Added Tax) identification number. This field is required for counterparts that are VAT-registered.",
      "required": true
    }
  },
  "entity": {
    "tax_id": {
      "description": "The entity's taxpayer identification number or tax ID. This field is required for entities that are non-VAT registered.",
      "required": false
    },
    "vat_id": {
      "description": "The entity's VAT (Value Added Tax) identification number. This field is required for entities that are VAT-registered.",
      "required": true
    }
  },
  "line_item": {
    "measure_unit": {
      "description": "Unit used to measure the quantity of the product (e.g. items, meters, kilograms)",
      "required": true
    },
    "tax_rate_value": {
      "description": "Percent minor units. Example: 12.5% is 1250. This field is only required on invoices issued by entities in the US, Pakistan, and other unsupported countries.",
      "required": false
    },
    "vat_rate_id": {
      "description": "Unique identifier of the vat rate object. This field is required for all entities in supported countries except the US and Pakistan.",
      "required": true
    }
  }
}

Get field requirements for invoice creation given the entity and counterpart details.

Authentication

AuthorizationBearer

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

Query parameters

counterpart_idstringOptionalformat: "uuid"

counterpart_billing_address_idstringOptionalformat: "uuid"

counterpart_countryenumOptional

counterpart_typeenumOptional

Allowed values:

entity_vat_id_idstringOptionalformat: "uuid"

counterpart_vat_id_idstringOptionalformat: "uuid"

Response

Successful Response

counterpartobject

Object describing the required fields for counterpart

entityobject

Object describing the required fields for entity

line_itemobject

Object describing the required fields for line items

Errors

401

Get Receivables Required Fields Request Unauthorized Error

422

Get Receivables Required Fields Request Unprocessable Entity Error

429

Get Receivables Required Fields Request Too Many Requests Error

Authentication

Headers

Query parameters

Response

Errors