Update invoice

Updates an existing invoice. Invoices can be updated as long as they are editable — this includes draft invoices, rejected invoices (so you can fix and resubmit), and issued invoices that have not yet been submitted to ANAF. Invoices with status cancelled or sent_to_provider, or that have already been uploaded to ANAF, cannot be updated.

PUT /api/v1/invoices/{uuid}

Headers

Path parameters

Request body

All fields are optional — only include the fields you want to update.

Invoice line object

e-Factura BT fields

These optional fields are used for advanced e-Factura (UBL) compliance:

UBL extensions (document-level)

The ublExtensions object supports UBL XML elements that don't have dedicated invoice fields. All sub-fields are optional. Unknown keys are silently stripped. Pass null to clear all extensions.

UBL extensions (line-level)

Each line item can include a ublExtensions object:

Request

curl -X PUT https://api.storno.ro/api/v1/invoices/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Company: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{
    "dueDate": "2024-03-30",
    "notes": "Payment terms: 45 days net",
    "lines": [
      {
        "description": "Web Development Services - Updated",
        "quantity": 15,
        "unitPrice": 100.00,
        "unitOfMeasure": "hours",
        "vatIncluded": false
      }
    ]
  }'

const response = await fetch('https://api.storno.ro/api/v1/invoices/7c9e6679-7425-40de-944b-e07fc1f90ae7', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Company': '550e8400-e29b-41d4-a716-446655440000',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dueDate: '2024-03-30',
    notes: 'Payment terms: 45 days net',
    lines: [
      {
        description: 'Web Development Services - Updated',
        quantity: 15,
        unitPrice: 100.00,
        unitOfMeasure: 'hours',
        vatIncluded: false
      }
    ]
  })
});

const data = await response.json();
// data.invoice — the updated invoice
// data.validation — UBL validation results

Response

Returns the updated invoice object along with UBL validation results.

{
  "invoice": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "number": "FAC-2024-001",
    "status": "draft",
    "direction": "outgoing",
    "currency": "RON",
    "exchangeRate": 1.0,
    "issueDate": "2024-02-15",
    "dueDate": "2024-03-30",
    "subtotal": 1500.00,
    "vatTotal": 285.00,
    "total": 1785.00,
    "amountPaid": 0.00,
    "balance": 1785.00,
    "notes": "Payment terms: 45 days net",
    "lines": [
      {
        "id": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
        "description": "Web Development Services - Updated",
        "quantity": 15.0,
        "unitPrice": 100.00,
        "unitOfMeasure": "hours",
        "vatRate": 19.0,
        "vatAmount": 285.00,
        "subtotal": 1500.00,
        "total": 1785.00
      }
    ],
    "updatedAt": "2024-02-15T10:45:00Z"
  },
  "validation": {
    "valid": true,
    "errors": [],
    "warnings": [],
    "schematronAvailable": true
  }
}

Error codes