Facturas de proveedor

Modificar una factura en borrador

Edita un comprobante en borrador con la versión leída: datos, líneas, IVA, percepciones y total. Un archivo nuevo reemplaza al anterior.

POST/api/v1/supplier-invoices/update

Permiso: supplier-invoices.prepare
Empresa: Opera sobre la empresa activa
Tipo: Escritura: pide Idempotency-Key
Respuesta: JSON

Encabezados

Cookietextorequerido
La cookie de sesión del usuario de la integración (__Secure-erp.session_token). Cuando esté la clave API, va en Authorization: Bearer. Ver Autenticación.
X-Expected-Companyuuidrequerido
La empresa sobre la que operás. Si no coincide con la de la credencial, responde 409. Ver Empresa activa.
Idempotency-Keytextorequerido
Una clave única por intento, de hasta 255 caracteres. Reintentar con la misma clave y los mismos datos devuelve el mismo resultado sin repetir la operación. Ver Idempotencia.

Cuerpo

JSON con Content-Type: application/json.

supplierInvoiceIduuidrequerido
versionenterorequerido
mínimo 1
kindopción
Valores: invoice debit-note credit-note customs-entry
supplierIduuidadmite null
letteropciónadmite null
Valores: A B C M
pointOfSaleenteroadmite null
mínimo 1, máximo 99999
legalNumbertextoadmite null
de 1 a 30 caracteres
documentDatefechaadmite null
accountingDatefechaadmite null
authorizationModeopciónadmite null
Valores: cae caea cai
authorizationCodetextoadmite null
formato `^\d{14}$`
authorizationExpiryfechaadmite null
currencyCodetexto
formato `^[A-Za-z]{3}$`
exchangeRatecualquiera
paymentTermIduuidadmite null
correctsInvoiceIduuidadmite null
creditDestinationopciónadmite null
Valores: apply-to-invoice on-account
reasontextoadmite null
hasta 300 caracteres
totalcualquiera
notestextoadmite null
hasta 1000 caracteres
lineslista de objeto
hasta 200
Campos de cada elemento (11)
- lineIduuidadmite null
- lineKindopciónrequerido
  Valores: receipt service invoice-line
- goodsReceiptLineIduuidadmite null
- correctsLineIduuidadmite null
- purchaseOrderLineIduuidadmite null
- itemIduuidadmite null
- descriptiontextoadmite null
  de 1 a 200 caracteres
- quantitynúmerorequerido
- unitPricecualquiera
- discountPercentcualquiera
- fromReadingsí o no
  Por defecto: false
vatlista de objetoadmite null
hasta 20
Campos de cada elemento (3)
- vatRateIduuidrequerido
- basenúmerorequerido
- amountnúmerorequerido
perceptionslista de objeto
hasta 20
Campos de cada elemento (5)
- perceptionKindopciónrequerido
  Valores: vat income-tax gross-income
- jurisdictionIduuidadmite null
- basecualquiera
- ratecualquiera
- amountnúmerorequerido
fileobjeto
Campos (2)
- fileNametextorequerido
  de 1 a 200 caracteres
- contentBase64textorequerido
  de 1 a 15728640 caracteres, formato `^[A-Za-z0-9+/]+={0,2}$`
confirmedFieldslista de opción
Valores: supplier kind letter pointOfSale legalNumber documentDate authorizationMode authorizationCode authorizationExpiry currencyCode exchangeRate correctsInvoice vat perceptions total lineshasta 16
ignoredReadingLineslista de entero
hasta 200

Respuesta

200 con este JSON.

iduuidrequerido
numbertextorequerido
labeltextorequerido
kindopciónrequerido
Valores: invoice debit-note credit-note customs-entry
statusopciónrequerido
Valores: draft registered void discarded
originopciónrequerido
Valores: domestic foreign
documentDatefecharequeridoadmite null
supplierobjetorequeridoadmite null
Campos (9)
- iduuidrequerido
- codeenterorequerido
- legalNametextorequerido
- taxIdtextorequerido
- originopciónrequerido
  Valores: domestic foreign
- statusopciónrequerido
  Valores: active inactive
- vatConditioncualquierarequerido
- isOccasionalsí o norequerido
- apocryphalSincefecharequeridoadmite null
currencyCodetextorequerido
totalcualquierarequerido
balancecualquierarequerido
verificationopciónrequerido
Valores: unverified verified rejected unavailable not-applicable
hasDifferencessí o norequerido
versionenterorequerido
mínimo 1
accountingDatefecharequeridoadmite null
letteropciónrequeridoadmite null
Valores: A B C M
arcaVoucherTypeenterorequeridoadmite null
pointOfSaleenterorequeridoadmite null
legalNumbercualquierarequerido
authorizationModeopciónrequeridoadmite null
Valores: cae caea cai
authorizationCodecualquierarequerido
authorizationExpiryfecharequeridoadmite null
exchangeRatecualquierarequerido
paymentTermobjetorequeridoadmite null
Campos (2)
- iduuidrequerido
- nametextorequerido
paymentPlanTexttextorequerido
installmentslista de objetorequerido
Campos de cada elemento (3)
- numberenterorequerido
- dueDatefecharequerido
- amounttextorequerido
correctsInvoiceobjetorequeridoadmite null
Campos (3)
- iduuidrequerido
- labeltextorequerido
- numbertextorequerido
creditDestinationopciónrequeridoadmite null
Valores: apply-to-invoice on-account
reasoncualquierarequerido
lineslista de objetorequerido
Campos de cada elemento (17)
- iduuidrequerido
- lineKindopciónrequerido
  Valores: receipt service invoice-line
- itemobjetorequerido
  Campos (6)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - unitCodetextorequerido
  - allowsDecimalssí o norequerido
  - statusopciónrequerido
    Valores: active inactive
- descriptiontextorequerido
- quantitynúmerorequerido
- unitPricetextorequerido
- discountPercentnúmerorequerido
- vatRateIdcualquierarequerido
- vatPercentagecualquierarequerido
- netAmounttextorequerido
- creditedQuantitynúmerorequerido
- quantityDifferencecualquierarequerido
- priceDifferencecualquierarequerido
- correctsLineIduuidrequeridoadmite null
- fromReadingsí o norequerido
- receiptobjetorequeridoadmite null
  Campos (13)
  - goodsReceiptLineIduuidrequerido
  - goodsReceiptIduuidrequerido
  - receiptNumberenterorequerido
  - receiptDatefecharequerido
  - purchaseOrderIduuidrequerido
  - orderNumberenterorequerido
  - orderCurrencytextorequerido
  - receivednúmerorequerido
  - invoicednúmerorequerido
  - pendingnúmerorequerido
  - orderUnitPricecualquierarequerido
  - orderDiscountPercentcualquierarequerido
  - unitCostcualquierarequerido
- orderLineobjetorequeridoadmite null
  Campos (9)
  - purchaseOrderLineIduuidrequerido
  - purchaseOrderIduuidrequerido
  - orderNumberenterorequerido
  - orderCurrencytextorequerido
  - orderednúmerorequerido
  - invoicednúmerorequerido
  - pendingnúmerorequerido
  - orderUnitPricecualquierarequerido
  - orderDiscountPercentcualquierarequerido
vatlista de objetorequerido
Campos de cada elemento (4)
- vatRateIdtextorequerido
- vatPercentagenúmerorequerido
- basetextorequerido
- amounttextorequerido
proposedVatlista de objetorequerido
Campos de cada elemento (4)
- vatRateIdtextorequerido
- vatPercentagenúmerorequerido
- basetextorequerido
- amounttextorequerido
perceptionslista de objetorequerido
Campos de cada elemento (5)
- perceptionKindopciónrequerido
  Valores: vat income-tax gross-income
- jurisdictionobjetorequeridoadmite null
  Campos (2)
  - iduuidrequerido
  - nametextorequerido
- basecualquierarequerido
- ratecualquierarequerido
- amounttextorequerido
totalsobjetorequerido
Campos (5)
- nettextorequerido
- vattextorequerido
- perceptionstextorequerido
- sumtextorequerido
- gapcualquierarequerido
controlslista de objetorequerido
Campos de cada elemento (4)
- codetextorequerido
- levelopciónrequerido
  Valores: error warning info
- texttextorequerido
- fieldcualquierarequerido
warningsAcceptedlista de textorequerido
verificationMessagecualquierarequerido
verifiedAtfecha y horarequeridoadmite null
notescualquierarequerido
fileobjetorequeridoadmite null
Campos (5)
- fileNametextorequerido
- mediaTypetextorequerido
- sizeBytesenterorequerido
- pageCountenterorequeridoadmite null
- uploadedAtfecha y horarequerido
readingobjetorequeridoadmite null
Campos (5)
- statusopciónrequerido
  Valores: running read failed
- failureopciónrequeridoadmite null
  Valores: unreadable not-an-invoice provider-unavailable timeout
- startedAtfecha y horarequerido
- finishedAtfecha y horarequeridoadmite null
- unassignedLineslista de objetorequerido
  Campos de cada elemento (6)
  - indexenterorequerido
  - codecualquierarequerido
  - descriptiontextorequerido
  - quantitycualquierarequerido
  - unitPricecualquierarequerido
  - amountcualquierarequerido
payablesí o norequerido
readingAvailablesí o norequerido
readFieldslista de textorequerido
ignoredReadingLineslista de enterorequerido
reviewFieldslista de objetorequerido
Campos de cada elemento (3)
- fieldtextorequerido
- labeltextorequerido
- reasontextorequerido
correctionslista de objetorequerido
Campos de cada elemento (6)
- iduuidrequerido
- labeltextorequerido
- numbertextorequerido
- kindopciónrequerido
  Valores: invoice debit-note credit-note customs-entry
- statusopciónrequerido
  Valores: draft registered void discarded
- totalcualquierarequerido
createdAtfecha y horarequerido
createdByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
registeredAtfecha y horarequeridoadmite null
registeredByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
voidedAtfecha y horarequeridoadmite null
voidedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
voidReasoncualquierarequerido
discardedAtfecha y horarequeridoadmite null
discardedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
discardReasoncualquierarequerido

Errores

Un rechazo responde application/problem+json con un code estable. Los más comunes en esta operación:

`401`	Falta la credencial o venció.
`403`	La credencial no tiene el permiso `supplier-invoices.prepare`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`409`	Otra persona cambió el registro desde que lo leíste (`record.stale`).
`422`	Datos inválidos o una regla de negocio rota, con el detalle por campo.
`503`	Sistema ocupado: reintentá después de `Retry-After` segundos.

La lista completa está en Errores.

curl
TypeScript

curl -X POST "$ERP_URL/api/v1/supplier-invoices/update" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "supplierInvoiceId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "version": 1
}'

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/supplier-invoices/update`, {
  method: "POST",
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "supplierInvoiceId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "version": 1
  }),
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "number": "texto",
  "label": "texto",
  "kind": "invoice",
  "status": "draft",
  "origin": "domestic",
  "documentDate": "2026-10-23",
  "supplier": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": 1,
    "legalName": "texto",
    "taxId": "texto",
    "origin": "domestic",
    "status": "active",
    "vatCondition": null,
    "isOccasional": false,
    "apocryphalSince": "2026-10-23"
  },
  "currencyCode": "texto",
  "total": null,
  "balance": null,
  "verification": "unverified",
  "hasDifferences": false,
  "version": 1,
  "accountingDate": "2026-10-23",
  "letter": "A",
  "arcaVoucherType": 1,
  "pointOfSale": 1,
  "legalNumber": null,
  "authorizationMode": "cae",
  "authorizationCode": null,
  "authorizationExpiry": "2026-10-23",
  "exchangeRate": null,
  "paymentTerm": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "name": "texto"
  },
  "paymentPlanText": "texto",
  "installments": [
    {
      "number": 1,
      "dueDate": "2026-10-23",
      "amount": "texto"
    }
  ],
  "correctsInvoice": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "label": "texto",
    "number": "texto"
  },
  "creditDestination": "apply-to-invoice",
  "reason": null,
  "lines": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "lineKind": "receipt",
      "item": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "unitCode": "texto",
        "allowsDecimals": false,
        "status": "active"
      },
      "description": "texto",
      "quantity": 100,
      "unitPrice": "texto",
      "discountPercent": 100,
      "vatRateId": null,
      "vatPercentage": null,
      "netAmount": "texto",
      "creditedQuantity": 100,
      "quantityDifference": null,
      "priceDifference": null,
      "correctsLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "fromReading": false,
      "receipt": {
        "goodsReceiptLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "goodsReceiptId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "receiptNumber": 1,
        "receiptDate": "2026-10-23",
        "purchaseOrderId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "orderNumber": 1,
        "orderCurrency": "texto",
        "received": 100,
        "invoiced": 100,
        "pending": 100,
        "orderUnitPrice": null,
        "orderDiscountPercent": null,
        "unitCost": null
      },
      "orderLine": {
        "purchaseOrderLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "purchaseOrderId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "orderNumber": 1,
        "orderCurrency": "texto",
        "ordered": 100,
        "invoiced": 100,
        "pending": 100,
        "orderUnitPrice": null,
        "orderDiscountPercent": null
      }
    }
  ],
  "vat": [
    {
      "vatRateId": "texto",
      "vatPercentage": 100,
      "base": "texto",
      "amount": "texto"
    }
  ],
  "proposedVat": [
    {
      "vatRateId": "texto",
      "vatPercentage": 100,
      "base": "texto",
      "amount": "texto"
    }
  ],
  "perceptions": [
    {
      "perceptionKind": "vat",
      "jurisdiction": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "name": "texto"
      },
      "base": null,
      "rate": null,
      "amount": "texto"
    }
  ],
  "totals": {
    "net": "texto",
    "vat": "texto",
    "perceptions": "texto",
    "sum": "texto",
    "gap": null
  },
  "controls": [
    {
      "code": "texto",
      "level": "error",
      "text": "texto",
      "field": null
    }
  ],
  "warningsAccepted": [
    "texto"
  ],
  "verificationMessage": null,
  "verifiedAt": "2026-10-23T14:30:00.000Z",
  "notes": null,
  "file": {
    "fileName": "texto",
    "mediaType": "texto",
    "sizeBytes": 1,
    "pageCount": 1,
    "uploadedAt": "2026-10-23T14:30:00.000Z"
  },
  "reading": {
    "status": "running",
    "failure": "unreadable",
    "startedAt": "2026-10-23T14:30:00.000Z",
    "finishedAt": "2026-10-23T14:30:00.000Z",
    "unassignedLines": [
      {
        "index": 1,
        "code": null,
        "description": "texto",
        "quantity": null,
        "unitPrice": null,
        "amount": null
      }
    ]
  },
  "payable": false,
  "readingAvailable": false,
  "readFields": [
    "texto"
  ],
  "ignoredReadingLines": [
    1
  ],
  "reviewFields": [
    {
      "field": "texto",
      "label": "texto",
      "reason": "texto"
    }
  ],
  "corrections": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "label": "texto",
      "number": "texto",
      "kind": "invoice",
      "status": "draft",
      "total": null
    }
  ],
  "createdAt": "2026-10-23T14:30:00.000Z",
  "createdBy": {
    "id": "texto",
    "name": null
  },
  "registeredAt": "2026-10-23T14:30:00.000Z",
  "registeredBy": {
    "id": "texto",
    "name": null
  },
  "voidedAt": "2026-10-23T14:30:00.000Z",
  "voidedBy": {
    "id": "texto",
    "name": null
  },
  "voidReason": null,
  "discardedAt": "2026-10-23T14:30:00.000Z",
  "discardedBy": {
    "id": "texto",
    "name": null
  },
  "discardReason": null
}