Facturación & pagos – 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.

Facturación & pagos

Ciclo de vida de facturas, líneas, transacciones, facturación electrónica y métodos de pago.

Resumen de la entidad

Factura

Expón el ciclo de vida de facturas para alinear finanzas, operaciones y equipos de cliente con una única fuente de ingresos.

Endpoints

POST https://api.flowtly.eu/e-invoices/send

Crear envío

Crea un recurso de factura.

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

Listar facturas

Obtén la colección de facturas con paginación y filtros por estado.

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

Crear factura

Crea una nueva factura con cliente, líneas y metadatos de pago.

GET https://api.flowtly.eu/invoices/draft

Listar borrador

Recupera la colección de recursos de Invoice.

GET https://api.flowtly.eu/invoices/name/{date}

Ver factura por ID

Consulta una factura con líneas y transacciones vinculadas.

POST https://api.flowtly.eu/invoices/send

Crear envío

Crea un recurso de factura.

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

Ver factura por ID

Consulta una factura con líneas y transacciones vinculadas.

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

Eliminar factura

Eliminar el recurso.

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

Actualizar factura

Actualiza estado, vencimiento o metadatos tras revisión.

GET https://api.flowtly.eu/invoices/{id}/send

Ver factura por ID

Consulta una factura con líneas y transacciones vinculadas.

POST https://api.flowtly.eu/invoices/{id}/send

Crea un recurso de factura.

Crea un recurso de factura.

Casos de uso

Sincroniza facturas con dashboards BI para vigilar vencidos y riesgo de caja.
Activa recordatorios al cliente cuando cambia el estado de la factura en Flowtly.

Campos del esquema

Invoice-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Campo Tipo Descripción
id integer Campo de ID.
name string Campo de nombre.
type string Campo de tipo.
parent object Campo padre.
childrenInvoices array Campo childrenInvoices.
client string Campo de cliente.
tinType string Campo tinType.
tinCountry string | null Campo tinCountry.
tin string | null Campo TIN.
bankAccount string Campo de cuenta bancaria.
amountNet number Campo amountNet.
amount number Campo de importe.
currency string | null Campo de divisa.
conversionRate number | null Campo de tipo de cambio.
generatedPdfExternalId string | null Campo generatedPdfExternalId.
issueDate string —
saleDate string —
dueDate string —
targetAmount number | null —
paymentMethod string —
paidInAdvance boolean —
notes string | null —
correctionReason string | null —
invoiceRows array —
eInvoicing object —
invoiceTransactions array —
internalComment string —
targetAmountNet number | null —
status string —

Resumen de la entidad

Línea de factura

Gestiona las líneas de factura con cantidad, precio unitario, impuestos y descripción para un control de facturación granular.

Endpoints

GET https://api.flowtly.eu/invoice-rows

Listar líneas de factura

Recupera la colección de recursos InvoiceRow.

POST https://api.flowtly.eu/invoice-rows

Crear línea de factura

Crea un recurso InvoiceRow.

GET https://api.flowtly.eu/invoice-rows/{id}

Obtener línea de factura por ID

Recuperar un único recurso por su identificador.

PATCH https://api.flowtly.eu/invoice-rows/{id}

Actualizar línea de factura

Actualizar campos de recursos utilizando JSON Merge Patch.

Casos de uso

Generar líneas de factura automáticamente a partir de hojas de horas aprobadas.
Enviar correcciones de partidas individuales desde su sistema de contabilidad.

Campos del esquema

InvoiceRow-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Campo Tipo Descripción
id integer Campo de ID.
classificationNumber string | null Campo classificationNumber.
unit string | null Campo de unidad.
quantity number Campo de cantidad.
vatRate string Campo vatRate.
netPrice string Campo netPrice.
netDiscountAmount string Campo netDiscountAmount.
productName string Campo de nombre de producto.
project string | null Campo de proyecto.
parentInvoiceRow object Campo parentInvoiceRow.
invoiceChildrenRows array Campo invoiceChildrenRows.

Resumen de la entidad

Transacción de factura

Rastrear qué transacciones bancarias liquidan qué facturas para la conciliación automática.

Endpoints

GET https://api.flowtly.eu/invoice-transactions

Listar transacciones de factura

Recupera la colección de recursos InvoiceTransaction.

POST https://api.flowtly.eu/invoice-transactions

Crear transacción de factura

Crea un recurso InvoiceTransaction.

GET https://api.flowtly.eu/invoice-transactions/{id}

Obtener transacción de factura por ID

Recuperar un único recurso por su identificador.

DELETE https://api.flowtly.eu/invoice-transactions/{id}

Eliminar transacción de factura

Eliminar el recurso.

PATCH https://api.flowtly.eu/invoice-transactions/{id}

Actualizar transacción de factura

Actualizar campos de recursos usando JSON Merge Patch.

Casos de uso

Emparejar pagos entrantes con facturas abiertas desde su feed bancario.
Conciliar pagos parciales y pagos en exceso en conjuntos de facturas.

Campos del esquema

InvoiceTransaction-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Campo Tipo Descripción
id integer Campo id.
invoice object Campo de factura.
transaction object Campo de transacción.
amount number | null Campo de cantidad.
date string Campo de fecha.

Resumen de la entidad

Facturación electrónica (KSeF)

Envía, recibe y consulta facturas electrónicas a través de la plataforma gubernamental KSeF para el cumplimiento fiscal.

Endpoints

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/download/xml

Listar xml

Recupera la colección de recursos de InvoiceDownload.

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/{id}/download/upo

Obtener factura electrónica (KSeF) por ID

Recuperar un único recurso por su identificador.

GET https://api.flowtly.eu/e-invoicing/invoices/inbound/{id}/download/xml

Obtener factura electrónica (KSeF) por ID

Recuperar un único recurso por su identificador.

POST https://api.flowtly.eu/e-invoicing/invoices/inbound/queue

Crear cola

Crea un recurso InboundInvoiceQueue.

POST https://api.flowtly.eu/e-invoicing/invoices/inbound/sync

Crear sincronización

Crea un recurso InboundInvoiceSync.

POST https://api.flowtly.eu/e-invoicing/invoices/{id}/correction

Crea un recurso InvoiceCorrectionSend.

Crea un recurso InvoiceCorrectionSend.

GET https://api.flowtly.eu/e-invoicing/invoices/download/xml

Listar xml

Recupera la colección de recursos de InvoiceDownload.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/pdf

Obtener factura electrónica (KSeF) por ID

Recuperar un único recurso por su identificador.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/preview/pdf

Obtener factura electrónica (KSeF) por ID

Recuperar un único recurso por su identificador.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/upo

Obtener factura electrónica (KSeF) por ID

Recuperar un único recurso por su identificador.

GET https://api.flowtly.eu/e-invoicing/invoices/{id}/download/xml

Obtener factura electrónica (KSeF) por ID

Recuperar un único recurso por su identificador.

POST https://api.flowtly.eu/e-invoicing/invoices/{id}/send

Crea un recurso InvoiceSend.

Crea un recurso InvoiceSend.

POST https://api.flowtly.eu/e-invoicing/ksef/session

Crear sesión

Crea un recurso KsefSession.

Casos de uso

Enviar automáticamente facturas de venta a KSeF y almacenar el recibo UPO oficial.
Descargar facturas de compra entrantes de KSeF en su flujo de trabajo de Cuentas por Pagar (AP).

Campos del esquema

InvoiceEInvoicing.jsonld-invoice.read_invoice_row.read_invoice_transaction.read_transaction.read_storage.read
Campo Tipo Descripción
@context object —
@id string —
@type string —
id integer —
provider string —
status string —
referenceNumber string | null —
documentId string | null —
acquisitionTimestamp string | null —
upoUrl string | null —
verificationLink string | null —
rejectionReason string | null —
providerPayload array | null —
einvoicingNumber string | null —

Resumen de la entidad

Método de pago

Configure métodos de pago (transferencia bancaria, tarjeta, etc.) y realice un seguimiento de las transacciones de pago.

Endpoints

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

Listar métodos de pago

Recupera la colección de recursos PaymentMethod.

GET https://api.flowtly.eu/payment-methods

Listar métodos de pago

Recupera la colección de recursos PaymentMethod.

POST https://api.flowtly.eu/payment-methods/create-setup-intent

Crear intención de configuración

Crea un recurso PaymentMethod.

GET https://api.flowtly.eu/payment-methods/{id}

Obtener método de pago por ID

Recuperar un único recurso por su identificador.

DELETE https://api.flowtly.eu/payment-methods/{id}

Eliminar método de pago

Eliminar el recurso.

PATCH https://api.flowtly.eu/payment-methods/{id}

Actualizar método de pago

Actualizar campos de recursos usando JSON Merge Patch.

Casos de uso

Establecer términos de pago predeterminados por cliente para la generación de facturas.
Consultar el historial de pagos para los extractos de cuenta del cliente.

Campos del esquema

PaymentMethod-payment_method.read
Campo Tipo Descripción
id string campo id.
type string campo de tipo.
ccBrand string campo ccBrand.
ccLastDigits string campo ccLastDigits.
ccExpMonth integer campo ccExpMonth.
ccExpYear integer campo ccExpYear.
externalId string campo externalId.
Whatsapp