*Workflows › Referencia › Acciones › Ventas*

# Sincronizar factura emitida fuera

> Crea o actualiza en Filmo la copia de una factura emitida en otro sistema (por ejemplo, un ERP). Filmo no la emite: queda bloqueada y marcada con su origen.

## De un vistazo

| Propiedad | Valor |
| --- | --- |
| Dominio | `invoices` |
| Grupo en el editor | Ventas › Facturas |
| Se ejecuta como | El propietario del workflow, con sus permisos |
| Permiso | Acceso de edición a Ventas. Los administradores siempre pasan; un módulo fuera del plan bloquea a todos. |
| Add-on | Documentos de venta |
| Destructiva | No: el catálogo MCP público no la marca como destructiva |
| También disponible en | API REST, MCP (`filmo_invoices_upsert_external`) |

ACCIÓN `invoices.upsertExternal`

## Entradas

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `originSystem` | string | Sí |  |
| `originExternalId` | string | Sí |  |
| `invoiceNumber` | string | Sí |  |
| `invoiceDate` | string | Sí |  |
| `lines` | object[] | Sí | Líneas de la factura. |
| `lines.description` | string | Sí |  |
| `lines.quantity` | string | Sí |  |
| `lines.unitPrice` | string | Sí |  |
| `lines.discountPercent` | string | No |  |
| `lines.taxType` | string | No |  |
| `lines.taxRate` | string | No |  |
| `dueDate` | string | No |  |
| `currency` | string | No |  |
| `contactId` | string | No |  |
| `contactTaxId` | string | No |  |
| `contactName` | string | No |  |
| `subTotal` | string | No |  |
| `taxTotal` | string | No |  |
| `total` | string | No |  |
| `externalStatus` | enum<string> | No |  `issued`, `voided` |
| `voidReason` | string | No |  |
| `paymentStatus` | enum<string> | No |  `unpaid`, `partially_paid`, `paid`, `overpaid` |
| `totalPaid` | string | No |  |
| `originUrl` | string | No |  |
| `originFileUrl` | string | No |  |
| `notes` | string | No |  |

## Salidas

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `invoiceId` | string |  |
| `invoiceNumber` | string |  |
| `status` | enum<string> |  `validated`, `voided` |
| `isExternallyIssued` | boolean |  |
| `created` | boolean |  |
| `changed` | boolean |  |

---

URL canónica: https://docs.filmo.io/es/workflows/reference/actions/invoices-upsertexternal  
Última actualización: 2026-10-25