VERSIONE 1.2
Esempi JSON
Esempi presenti nella specifica. I valori identificativi sono dimostrativi; e-mail sostituite con example.com e coordinate bancarie lasciate vuote.
Le collection vuote di get_response.json illustrano la struttura della risposta; non sono esempi di singoli record.
Risposta GET · struttura generale
Scarica get_response.json{
"version": "1.0",
"message": "",
"sync-datetime": "01/10/2026@07:00:00",
"debug": "",
"ok": true,
"login": true,
"customers": [],
"customers_deleted": [],
"vendors": [],
"vendors_deleted": [],
"services": [],
"services_deleted": [],
"products": [],
"products_deleted": [],
"invoices": [],
"invoices_deleted": [],
"creditnotes": [],
"creditnotes_deleted": [],
"cinvoices": [],
"cinvoices_deleted": [],
"ccreditnotes": [],
"ccreditnotes_deleted": [],
"financial_transactions": [],
"financial_transactions_deleted": [],
"payments": [],
"payments_deleted": []
}Fornitori
Scarica vendors.json{
"vendors": [
{
"id_customer": "V250",
"nr_customer": "250",
"name": "",
"surname": "",
"company": "Fornitore SA",
"adresse": "Via Esempio 20",
"adresse2": "",
"cap": "6900",
"location": "Lugano",
"tel1": "",
"tel2": "",
"fax": "",
"email": "vendor@example.com",
"web": "",
"cust_currency": "CHF",
"acct_code": "2000",
"cust_title": "",
"cust_status": "",
"cust_lang": "IT",
"resp1": "",
"cust_exempt_iva": "0",
"cust_country_code": "CH",
"vat_number": "",
"tax_id": "",
"cf_acct_vendor_bank_name": "Banca Esempio",
"cf_acct_vendor_bank_zip": "6900",
"cf_acct_vendor_bank_city": "Lugano",
"cf_acct_vendor_bank_post_account": "",
"cf_acct_vendor_bank_pvbr_code": "",
"cf_acct_vendor_bank_iban": ""
}
]
}Documenti clienti
Scarica invoices.json{
"invoices": [
{
"id_invoice": "100001",
"num_invoice": "2026-00125",
"cf_acct_voucher": "125",
"date_invoice": "2026-09-15",
"currency": "CHF",
"inv_exch_rate": "1",
"nr_customer": "1001",
"inv_pvbr_ref": "",
"acct_code": "1100",
"inv_title": "Fattura 2026-00125",
"action": "CU",
"id_bank": "",
"is_iva": "1",
"payment_condition_code": "30",
"due_date": "2026-10-15",
"company": "Cliente SA",
"name": "",
"surname": "",
"adresse": "Via Esempio 10",
"cap": "6900",
"location": "Lugano",
"cust_country_code": "CH",
"tel1": "",
"tel2": "",
"email": "billing@example.com",
"web": "",
"resp1": "",
"email_invoice": [
"billing@example.com"
],
"doc_wiva": "1",
"inv_total": "1081.00",
"total_no_iva": "1000.00",
"iva_total": "81.00",
"inv_total_main_currency": "1081.00",
"rows": [
{
"id_invoice": "100001",
"description": "Prestazione",
"ordering": "1",
"qt_accounting": "1",
"total_row": "1000.00",
"acct_code": "3200",
"cc_code": "",
"iva_row": "8.1",
"discount_real": "0",
"discount_row": "0",
"id_pr": "0",
"id_se": "0"
}
]
}
]
}Documenti fornitori
Scarica cinvoices.json{
"cinvoices": [
{
"id_invoice": "200001",
"num_invoice": "RE-2026-7845",
"date_invoice": "2026-09-20",
"due_date": "2026-10-20",
"currency": "CHF",
"inv_exch_rate": "1",
"nr_customer": "250",
"acct_code": "2000",
"payment_condition_code": "30",
"qrcode": "",
"qr_iban": "1",
"company": "Fornitore SA",
"name": "",
"surname": "",
"adresse": "Via Fornitore 20",
"cap": "6900",
"location": "Lugano",
"cust_country_code": "CH",
"vat_number": "",
"tax_id": "",
"cf_acct_vendor_bank_name": "Banca Esempio",
"cf_acct_vendor_bank_zip": "6900",
"cf_acct_vendor_bank_city": "Lugano",
"cf_acct_vendor_bank_post_account": "",
"cf_acct_vendor_bank_pvbr_code": "",
"cf_acct_vendor_bank_iban": "",
"cf_acct_vendor_bank_bic": "",
"vendor_num": "",
"action": "CU",
"is_iva": "1",
"id_bank": "",
"doc_wiva": "1",
"inv_total": "2162.00",
"total_no_iva": "2000.00",
"iva_total": "162.00",
"inv_total_main_currency": "2162.00",
"rows": [
{
"id_invoice": "200001",
"description": "Acquisto materiale",
"ordering": "1",
"qt_accounting": "1",
"total_row": "2000.00",
"acct_code": "4200",
"cc_code": "100",
"iva_row": "8.1",
"only_vat": "0",
"id_pr": "0",
"id_se": "0"
}
]
}
]
}Cancellazione documenti clienti
Scarica invoices_deleted.json{
"invoices_deleted": [
{
"id": "100001",
"action": "D"
}
]
}Giornale Dare/Avere
Scarica financial_transactions.json{
"financial_transactions": [
{
"id": "FT-2026-000125",
"type": "GL",
"action": "CU",
"text": "Registrazione contabile",
"date": "2026-09-30",
"currency_rate": "1",
"debits": [
{
"date": "2026-09-30",
"text": "Costo materiale",
"amount": "1081.00",
"acct_code": "4200",
"cc_code": "100",
"currency": "CHF",
"vat_perc": "8.1",
"amount_base": "1081.00",
"doc_wiva": "1"
}
],
"credits": [
{
"date": "2026-09-30",
"text": "Contropartita",
"amount": "1081.00",
"acct_code": "2000",
"cc_code": "",
"currency": "CHF",
"vat_perc": "",
"amount_base": "1081.00",
"doc_wiva": "0"
}
]
}
]
}POST · Esito elaborazione
Scarica processing_result.json{
"data": {
"invoices": [
{
"id_accounting": "F20260000125",
"id_teleutias": "100001",
"ok": true,
"message": "",
"total": "1081.00",
"voucher_acct": "125"
}
],
"cinvoices": [
{
"id_accounting": "A20260000200",
"id_teleutias": "200001",
"ok": true,
"message": "",
"total": "2162.00",
"voucher_acct": "200"
}
],
"financial_transactions": [
{
"id_accounting": "FT2026000125",
"id_teleutias": "FT-2026-000125",
"ok": true,
"message": "",
"total": "1000.00",
"type": "GL",
"voucher_acct": "300"
}
]
}
}POST · Piano dei conti e centri di costo
Scarica account_structure.json{
"data": {
"accounts": [
{
"id_ow": "95",
"AccCode": "1100",
"DescrIt": "Debitori",
"DescrEn": "Accounts receivable",
"DescrDe": "Debitoren",
"DescrFr": "Débiteurs",
"Class": "110",
"Type": "0",
"Currency": "CHF"
}
],
"costcenters": [
{
"id_ow": "95",
"Code": "100",
"DescrIt": "Amministrazione",
"DescrEn": "Administration",
"DescrDe": "Verwaltung",
"DescrFr": "Administration",
"Type": "1"
}
]
}
}POST · Incassi e pagamenti
Scarica outgoing_payments.json{
"data": {
"client_payments": [
{
"id_ow": "95",
"VoucherNbr": "15025",
"VoucherDate": "2026-09-30",
"ClientNbr": "1001",
"Currency": "CHF",
"CurrencyRate": 1,
"TotalBc": 1081.0,
"TotalMc": 1081.0,
"VoucherText": "Incasso fattura 2026-00125",
"VoucherType": "Z",
"CounterAccountCode": "1020",
"HeaderId": "12345",
"PaidHeaderId": "98765",
"IdAdjustement": "0",
"DocumentType": "I"
}
],
"vendor_payments": [
{
"id_ow": "95",
"VoucherNbr": "16020",
"VoucherDate": "2026-09-30",
"supplierNbr": "250",
"Currency": "CHF",
"CurrencyRate": 1,
"TotalBc": 2162.0,
"TotalMc": 2162.0,
"VoucherText": "Pagamento fattura RE-2026-7845",
"VoucherType": "Z",
"CounterAccountCode": "1020",
"HeaderId": "22345",
"PaidHeaderId": "88765",
"IdAdjustement": "0",
"DocumentType": "I"
}
]
}
}Esempi in attesa di conferma
customers.json: la specifica elenca i campi, ma non contiene un payload completo. creditnotes.json e ccreditnotes.json: manca uno schema completo delle chiavi e delle righe. payments.json (GET): non è esplicitato il campo per correlare l’incasso alla fattura. Questi esempi saranno aggiunti dopo la conferma del contratto.
Il payload POST outgoing_payments.json documenta un flusso distinto da GET payments.