Clienti e controparte
Clienti, contatti e controparte — mantieni la sincronizzazione tra il tuo CRM e Flowtly.
Cliente
Endpoint
| GET | /clients | Recupera la raccolta di risorse Client. |
| POST | /clients | Crea una risorsa Client. |
| GET | /clients/{id} | Recupera una risorsa Client. |
| PATCH | /clients/{id} | Aggiorna la risorsa Client. |
| GET | /clients/{id}/documents | Recupera una risorsa Client. |
| GET | /clients/search | Recupera la raccolta di risorse Client. |
Campi schema
| Campo | Tipo | Descrizione |
|---|---|---|
| country* | string (iri-reference) | |
| currency* | string (iri-reference) | |
| defaultCost | string,null (iri-reference) | |
| status* | string | |
| attributeSet | string,null (iri-reference) | |
| name* | string | |
| dueDays | integer | |
| tinType* | string | |
| tinCountry | stringnull | |
| tin | stringnull | |
| externalPaymentCustomerId | stringnull | |
| invoiceComment | stringnull | |
| defaultTaxRate | stringnull | |
| documentsLanguage | string | |
| addressPhoneNumber | stringnull | |
| addressCity | stringnull | |
| addressPostCode | stringnull | |
| addressStreetLine | stringnull | |
| addressBuildingNumber | stringnull | |
| addressLocaleNumber | stringnull | |
| addressCountry | string,null (iri-reference) | |
| clientContacts | array | |
| allowDuplicate | booleannull | Not persisted (no ORM\Column): an escape hatch for POST /clients only, mirroring CounterpartyCreateByTypeInput::allowDuplicate. When true, ClientCreateProcessor::refuseIfDuplicate() skips the duplicate-party guard, matching the human-facing PATCH-and-attach pattern in CounterpartyCreateByTypeProcessor. |
| vatNumber | stringnull |
Contatto Cliente
Endpoint
| GET | /client-contacts | Recupera la raccolta di risorse ClientContact. |
| POST | /client-contacts | Crea una risorsa ClientContact. |
| GET | /client-contacts/{id} | Recupera una risorsa ClientContact. |
| PATCH | /client-contacts/{id} | Aggiorna la risorsa ClientContact. |
| DELETE | /client-contacts/{id} | Rimuove la risorsa ClientContact. |
Campi schema
| Campo | Tipo | Descrizione |
|---|---|---|
| id | integer | |
| client | string (iri-reference) | |
| type* | string | |
| position | integer | |
| email* | string (email) | |
| name* | string | |
| title | stringnull | |
| phone | stringnull | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) | |
| possibleTypes | string |
Nota Cliente
Endpoint
| GET | /client-notes | Recupera la raccolta di risorse ClientNote. |
| POST | /client-notes | Crea una risorsa ClientNote. |
| GET | /client-notes/{id} | Recupera una risorsa ClientNote. |
| PATCH | /client-notes/{id} | Aggiorna la risorsa ClientNote. |
| DELETE | /client-notes/{id} | Rimuove la risorsa ClientNote. |
Campi schema
| Campo | Tipo | Descrizione |
|---|---|---|
| id | string | |
| client* | string (iri-reference) | |
| employee* | string (iri-reference) | |
| note* | string | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) |
Controparte
Endpoint
| GET | /counterparties | Recupera la raccolta di risorse Counterparty. |
| POST | /counterparties | Crea una risorsa Counterparty. |
| GET | /counterparties/{id} | Recupera una risorsa Counterparty. |
| PATCH | /counterparties/{id} | Aggiorna la risorsa Counterparty. |
| DELETE | /counterparties/{id} | Rimuove la risorsa Counterparty. |
| POST | /counterparties/{id}/enrich-branding-ai | Queue single counterparty branding enrich via AI |
| POST | /counterparties/{id}/merge | Merge counterparties |
| POST | /counterparties/enrich-branding-ai | Queue counterparties branding enrich via AI |
| POST | /counterparty | Create supplier/client + counterparty by type |
| PATCH | /counterparty/{id} | Update supplier/client + counterparty by type |
| GET | /counterparty/dedupe-check | Advisory duplicate check for a party. |
Campi schema
| Campo | Tipo | Descrizione |
|---|---|---|
| id | integer | |
| type | string | |
| requireAttachment | boolean | |
| cyclic | boolean | |
| budgetNeutral | boolean | |
| logoUrl | stringnull | |
| corporateWebsiteUrl | stringnull | |
| displayName | string | |
| costGroupIcon | stringnull |
Conto bancario controparte
Endpoint
| POST | /counterparty-bank-accounts | Crea una risorsa CounterpartyBankAccount. |
| DELETE | /counterparty-bank-accounts/{id} | Rimuove la risorsa CounterpartyBankAccount. |
Campi schema
| Campo | Tipo | Descrizione |
|---|---|---|
| id | integer | |
| counterparty | string (iri-reference) | |
| accountNumber | string | |
| accountNumberNormalized | string | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) |
Template Riga Fattura Controparte
Endpoint
| GET | /counterparties/{id}/invoice-line-templates | A counterparty's line templates, rendered for a billing period. |
| POST | /counterparty-invoice-line-templates | Crea una risorsa CounterpartyInvoiceLineTemplate. |
| GET | /counterparty-invoice-line-templates/{id} | Recupera una risorsa CounterpartyInvoiceLineTemplate. |
| PATCH | /counterparty-invoice-line-templates/{id} | Aggiorna la risorsa CounterpartyInvoiceLineTemplate. |
| DELETE | /counterparty-invoice-line-templates/{id} | Rimuove la risorsa CounterpartyInvoiceLineTemplate. |
Campi schema
| Campo | Tipo | Descrizione |
|---|---|---|
| id | integer | |
| name* | string | The pick-list label the operator chooses by — "Spectris", not the wording. |
| text* | string | The contractual wording, with an optional `{period}` / `{quarter}` token. |
| sortOrder | integer | Pick-list order only. It implies no line order — nothing generates lines. |