Clientes & contrapartes – plataforma para desarrolladores de Flowtly

Usa esta instantánea curada del esquema OpenAPI de Flowtly para planear integraciones, automatizar procesos y sincronizar los datos críticos.

Estado de la documentación

Última sincronización: 2026-04-03 18:31 (versión de la app 2.0.0)

Solo exponemos un conjunto limitado de entidades. Ejecuta ambos comandos de sincronización cuando Flowtly lance novedades para actualizar los datos.

Clientes & contrapartes

Datos maestros de clientes, contactos, notas y gestión de contrapartes.

Resumen de la entidad

Cliente

Mantén CRM y delivery alineados con registros de cliente, contactos y documentos en Flowtly.

Endpoints

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

Listar clientes

Obtén clientes con paginación para revisión y segmentación de cuentas.

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

Crear cliente

Crea un registro de cliente con datos legales y de contacto.

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

Búsqueda de lista

Recupera la colección de recursos de Cliente.

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

Ver cliente por ID

Consulta un perfil de cliente y sus contactos asociados.

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

Actualizar cliente

Actualiza datos de cliente tras onboarding o cambios de cuenta.

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

Ver cliente por ID

Consulta un perfil de cliente y sus contactos asociados.

Casos de uso

Sincroniza cuentas CRM cualificadas en Flowtly antes del inicio del proyecto.
Usa actualizaciones de cliente para alinear facturación, acuerdos y ownership de cuenta.

Campos del esquema

Client-client.read_client_contact.read_storage.read
Campo Tipo Descripción
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 —

Resumen de la entidad

Contacto de cliente

Almacena y gestiona múltiples contactos por cliente para comunicación, facturación y coordinación de proyectos.

Endpoints

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

Listar contactos de cliente

Recupera la colección de recursos de ClientContact.

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

Crear contacto de cliente

Crea un recurso de ClientContact.

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

Obtener contacto de cliente por ID

Recuperar un único recurso por su identificador.

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

Eliminar contacto de cliente

Eliminar el recurso.

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

Actualizar contacto de cliente

Actualizar campos de recurso utilizando JSON Merge Patch.

Casos de uso

Importar contactos de tomadores de decisiones de tu CRM para el mapeo de partes interesadas del proyecto.
Sincronizar contactos de facturación para asegurar que las facturas lleguen a la persona correcta.

Campos del esquema

ClientContact-client.read_client_contact.read_storage.read
Campo Tipo Descripción
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.

Resumen de la entidad

Nota de cliente

Realice un seguimiento de la inteligencia de ventas, el historial de cuentas y el contexto de las relaciones junto con los registros de los clientes.

Endpoints

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

Listar notas de clientes

Recupera la colección de recursos ClientNote.

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

Crear nota de cliente

Crea un recurso ClientNote.

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

Obtener nota de cliente por ID

Recupera un solo recurso por su identificador.

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

Eliminar nota de cliente

Eliminar el recurso.

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

Actualizar nota de cliente

Actualiza los campos del recurso utilizando JSON Merge Patch.

Casos de uso

Enviar notas de actividad de CRM a Flowtly para visibilidad entre equipos.
Registrar decisiones clave de la cuenta para fines de auditoría y traspaso.

Campos del esquema

ClientNote-client_note.read
Campo Tipo Descripción
id string campo de id.
client string campo de cliente.
employee string campo de empleado.
note string campo de nota.
updatedAt string campo de updatedAt.

Resumen de la entidad

Contraparte

Gestionar los datos maestros de contrapartes con identificadores legales, cuentas bancarias y direcciones para transacciones y cumplimiento.

Endpoints

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

Listar contrapartes

Recupera la colección de recursos de contraparte.

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

Crear contraparte

Crea un recurso de contraparte.

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

Crear enriquecimiento de marca por IA

Poner en cola el enriquecimiento de marca de contrapartes mediante IA

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

Obtener contraparte por ID

Recuperar un único recurso por su identificador.

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

Eliminar contraparte

Eliminar el recurso.

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

Actualizar contraparte

Actualizar campos de recursos usando JSON Merge Patch.

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

Poner en cola el enriquecimiento de marca de una sola contraparte mediante IA

Poner en cola el enriquecimiento de marca de una sola contraparte mediante IA

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

Fusionar contrapartes

Fusionar contrapartes

Casos de uso

Elimine duplicados de proveedores y clientes sincronizando los registros de contrapartes con su ERP.
Valide los identificadores fiscales de contrapartes contra los registros gubernamentales.

Campos del esquema

Counterparty-counterparty.read_counterparty.item.read
Campo Tipo Descripción
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