Passa al contenuto principale

AccountBilling

Billing profile: the holder the documents are made out to, with its tax and electronic invoicing data

account_billing_idintegerrequired
legal_entity objectrequired

Legal form of the holder of a billing profile, with its group

legal_entity_group objectrequired

Group of legal forms, such as private individuals or Italian companies

group_codestringrequired

Code of the group, currently PRIVATE, ITALIAN_INDIVIDUAL_COMPANY, ITALIAN_LIMITED_COMPANY, ITALIAN_COOPERATIVE_COMPANY, ITALIAN_PUBLIC_ADMINISTRATION, FOREIGN_COMPANY or OTHER

group_namestringrequired

Name of the group, in Italian

tax_regime objectrequired

Tax regime: how VAT applies to the documents

regime_codestringrequired

One of ORDINARY, SPLIT_PAYMENT, EU_VIES, EU_EXPORTER (habitual exporter), EXTRA_EU, VATICAN, SANMARINO or ART_26

regime_namestringrequired

Name of the regime, in Italian, for example Ordinario

code_edocumentstring | nullnullablerequired

Nature code of the operation on the electronic invoice (Natura) when VAT is not applied, for example N2.1; null for the regimes with VAT

tax_ratefloatrequired

VAT rate as a fraction, for example 0.22 for 22%

entity_codestringrequired

Code of the legal form: ITA_PVT, NOITA_PVT, ITA_INDIVIDUALE, ITA_CAPITALI, ITA_PERSONE, ITA_ASSNOCOMM, ITA_ASSCOMM, ITA_ALTRO, ITA_PA, EU_ALTRO, NOEU_ALTRO, VATICAN_NOPVT, SANMARINO_NOPVT or FORBIDDEN_NOITA_NOPVT

entity_namestringrequired

Name of the legal form, in Italian

tax_regime objectrequired

Tax regime: how VAT applies to the documents

regime_codestringrequired

One of ORDINARY, SPLIT_PAYMENT, EU_VIES, EU_EXPORTER (habitual exporter), EXTRA_EU, VATICAN, SANMARINO or ART_26

regime_namestringrequired

Name of the regime, in Italian, for example Ordinario

code_edocumentstring | nullnullablerequired

Nature code of the operation on the electronic invoice (Natura) when VAT is not applied, for example N2.1; null for the regimes with VAT

tax_ratefloatrequired

VAT rate as a fraction, for example 0.22 for 22%

organizationstring | nullnullablerequired
namestring | nullnullablerequired
surnamestring | nullnullablerequired
addressstringrequired
citystringrequired
statestringrequired

Province: the acronym of the Italian province, for example VI, or EE outside Italy

postal_codestringrequired
country objectrequired
iso_code_2stringrequired

ie. IT

iso_code_3stringrequired

ie. ITA

country_namestringrequired

Name of the country in Italian; the local name when there is no translation

local_namestringrequired

Name of the country in its own language, for example Deutschland

phone_codestringrequired

International calling code, without +, for example 39

continentstringrequired

Continent, in English, for example Europe or North America

regionstringrequired

Area of the country: EU (European Union) or EXTRAEU

genderstring | nullnullablerequired

Gender of the holder: M or F; null when not given

birth_datedatenullablerequired

Date of birth of the holder; null when not given

birth_placestring | nullnullablerequired

Place of birth of the holder; null when not given

phonestring | nullnullablerequired

Phone, usually in the form 0039.0123456789: 00 and the international prefix, a dot, the number; null when not given

vat_numberstring | nullnullablerequired

VAT number of the holder (partita IVA in Italy); null when it has none

is_vat_groupbooleanrequired

Whether the holder belongs to an Italian VAT group (Gruppo IVA), whose members share the VAT number and have each their own tax code

fiscal_codestringrequired

Tax code of the holder (codice fiscale in Italy)

edocument_pecstring | nullnullablerequired

PEC address (certified email, Posta Elettronica Certificata) to which SDI, the Italian e-invoicing exchange system, delivers the electronic invoices when there is no recipient code; null when not given

edocument_codestring | nullnullablerequired

Recipient code (Codice Destinatario) with which SDI, the Italian e-invoicing exchange system, delivers the electronic invoices: 7 characters, 6 for the public administration; null when not given

exporter_expirydatenullablerequired

Expiry date of the declaration of intent (dichiarazione d'intento) of a habitual exporter, whose invoices are without VAT; null when not given

exporter_numberstring | nullnullablerequired

Protocol number of the declaration of intent of a habitual exporter, written on the electronic invoices; null when not given

exporter_datedatenullablerequired

Date of the electronic receipt of the declaration of intent, issued by the Italian Revenue Agency (Agenzia delle Entrate); null when not given

is_split_paymentbooleanrequired

Whether split payment (scissione dei pagamenti) applies: the tax regime is SPLIT_PAYMENT, and the customer pays the VAT of the invoices directly to the Italian State

AccountBilling
{
"account_billing_id": 0,
"legal_entity": {
"legal_entity_group": {
"group_code": "string",
"group_name": "string"
},
"tax_regime": {
"regime_code": "string",
"regime_name": "string",
"code_edocument": "string",
"tax_rate": 0
},
"entity_code": "string",
"entity_name": "string"
},
"tax_regime": {
"regime_code": "string",
"regime_name": "string",
"code_edocument": "string",
"tax_rate": 0
},
"organization": "string",
"name": "string",
"surname": "string",
"address": "string",
"city": "string",
"state": "string",
"postal_code": "string",
"country": {
"iso_code_2": "string",
"iso_code_3": "string",
"country_name": "string",
"local_name": "string",
"phone_code": "string",
"continent": "string",
"region": "string"
},
"gender": "string",
"birth_date": "2024-07-29",
"birth_place": "string",
"phone": "string",
"vat_number": "string",
"is_vat_group": true,
"fiscal_code": "string",
"edocument_pec": "string",
"edocument_code": "string",
"exporter_expiry": "2024-07-29",
"exporter_number": "string",
"exporter_date": "2024-07-29",
"is_split_payment": true
}