Clienti e controparti – costruisci su Flowtly

Usa questo snapshot curato dello schema OpenAPI di Flowtly per pianificare integrazioni, automatizzare workflow e sincronizzare i dati su cui i tuoi team fanno affidamento.

Stato della documentazione

Ultima sincronizzazione il 2026-04-03 18:31 (versione app 2.0.0)

Solo un sottoinsieme di entità è reso pubblico. Esegui entrambi i comandi di sincronizzazione per aggiornare questa documentazione quando l'app Flowtly introduce nuove funzionalità.

Clienti e controparti

Dati anagrafici clienti, contatti, note e gestione delle controparti.

Panoramica entità

Cliente

Mantieni allineati CRM e sistemi di delivery con i record clienti, i contatti e i riferimenti documentali di Flowtly.

Endpoint

GET https://api.flowtly.eu/clients

Elenca clienti

Recupera la raccolta di risorse Client.

POST https://api.flowtly.eu/clients

Crea cliente

Crea una risorsa Client.

GET https://api.flowtly.eu/clients/search

Elenca ricerca

Recupera la raccolta di risorse Client.

GET https://api.flowtly.eu/clients/{id}

Ottieni cliente per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/clients/{id}

Aggiorna cliente

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/clients/{id}/documents

Ottieni cliente per ID

Recupera una singola risorsa tramite il suo identificatore.

Casi d'uso

Sincronizza gli account CRM qualificati in Flowtly prima dell'avvio del progetto.
Utilizza gli aggiornamenti cliente per mantenere allineati fatturazione, accordi e titolarità degli account.

Campi dello schema

Client-client.read_client_contact.read_storage.read
Campo Tipo Descrizione
id integer Campo id.
country string Campo country.
currency string Campo currency.
defaultCost string | null Campo defaultCost.
status string Campo status.
attributeSet string | null Campo attributeSet.
name string Campo name.
dueDays integer Campo dueDays.
tinType string Campo tinType.
tinCountry string | null Campo tinCountry.
tin string | null Campo tin.
externalPaymentCustomerId string | null Campo externalPaymentCustomerId.
invoiceComment string | null Campo invoiceComment.
defaultTaxRate string | null Campo defaultTaxRate.
documentsLanguage string Campo documentsLanguage.
addressPhoneNumber string | null —
addressCity string | null —
addressPostCode string | null —
addressStreetLine string | null —
addressBuildingNumber string | null —
addressLocaleNumber string | null —
addressCountry string | null —
clientContacts array —
costGroup array | null —
costGroupIcon string | null —
vatNumber string | null —

Panoramica entità

Contatto cliente

Archivia e gestisci più contatti per cliente per la comunicazione, la fatturazione e il coordinamento dei progetti.

Endpoint

GET https://api.flowtly.eu/client-contacts

Elenca contatti cliente

Recupera la raccolta di risorse ClientContact.

POST https://api.flowtly.eu/client-contacts

Crea contatto cliente

Crea una risorsa ClientContact.

GET https://api.flowtly.eu/client-contacts/{id}

Ottieni contatto cliente per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/client-contacts/{id}

Elimina contatto cliente

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/client-contacts/{id}

Aggiorna contatto cliente

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Importa i contatti dei decision maker dal tuo CRM per la mappatura degli stakeholder di progetto.
Sincronizza i contatti di fatturazione per garantire che le fatture raggiungano la persona giusta.

Campi dello schema

ClientContact-client.read_client_contact.read_storage.read
Campo Tipo Descrizione
id integer Campo id.
type string Campo type.
position integer Campo position.
email string Campo email.
name string Campo name.
title string | null Campo title.
phone string | null Campo phone.

Panoramica entità

Nota cliente

Tieni traccia dell'intelligence commerciale, della storia degli account e del contesto relazionale accanto ai record cliente.

Endpoint

GET https://api.flowtly.eu/client-notes

Elenca note cliente

Recupera la raccolta di risorse ClientNote.

POST https://api.flowtly.eu/client-notes

Crea nota cliente

Crea una risorsa ClientNote.

GET https://api.flowtly.eu/client-notes/{id}

Ottieni nota cliente per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/client-notes/{id}

Elimina nota cliente

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/client-notes/{id}

Aggiorna nota cliente

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Invia le note di attività CRM in Flowtly per la visibilità cross-team.
Registra le decisioni chiave degli account per finalità di audit e passaggio di consegne.

Campi dello schema

ClientNote-client_note.read
Campo Tipo Descrizione
id string Campo id.
client string Campo client.
employee string Campo employee.
note string Campo note.
updatedAt string Campo updatedAt.

Panoramica entità

Controparte

Gestisci i dati anagrafici delle controparti con identificatori legali, conti bancari e indirizzi per transazioni e conformità.

Endpoint

GET https://api.flowtly.eu/counterparties

Elenca controparti

Recupera la raccolta di risorse Counterparty.

POST https://api.flowtly.eu/counterparties

Crea controparte

Crea una risorsa Counterparty.

POST https://api.flowtly.eu/counterparties/enrich-branding-ai

Crea arricchimento branding AI

Accoda l'arricchimento del branding delle controparti tramite AI.

GET https://api.flowtly.eu/counterparties/{id}

Ottieni controparte per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/counterparties/{id}

Elimina controparte

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/counterparties/{id}

Aggiorna controparte

Aggiorna i campi della risorsa tramite JSON Merge Patch.

POST https://api.flowtly.eu/counterparties/{id}/enrich-branding-ai

Accoda arricchimento branding singola controparte tramite AI

Accoda l'arricchimento del branding di una singola controparte tramite AI.

POST https://api.flowtly.eu/counterparties/{id}/merge

Unisci controparti

Unisci controparti.

Casi d'uso

Deduplicazione di fornitori e clienti sincronizzando i record delle controparti con il tuo ERP.
Convalida i codici fiscali delle controparti rispetto ai registri governativi.

Campi dello schema

Counterparty-counterparty.read_counterparty.item.read
Campo Tipo Descrizione
id integer Campo id.
type string Campo type.
supplier string | null Campo supplier.
client string | null Campo client.
requireAttachment boolean Campo requireAttachment.
cyclic boolean Campo cyclic.
budgetNeutral boolean Campo budgetNeutral.
logoUrl string | null Campo logoUrl.
corporateWebsiteUrl string | null Campo corporateWebsiteUrl.
defaultProject string | null Campo defaultProject.
bankAccounts array Campo bankAccounts.
transactionsCount integer Campo transactionsCount.
tin string | null Campo tin.
supplierTin string | null Campo supplierTin.
clientTin string | null —
displayName string —
costGroup array | null —
costGroupIcon string | null —
Whatsapp