Create Invoice

Endpoint

POST /invoices

Authentication

Required: Authorization header with valid token

Request Body

JSON

{
  "invoiceId": "INV-2024-001",
  "date": "2024-01-15",
  "deadline": "2024-02-15",
  "amount": 5000.00,
  "mediaId": "uuid",
  "mediaName": "invoice.pdf",
  "status": "PENDING",
  "contractId": "uuid",
  "bookingIds": ["uuid", "uuid"],
  "startDate": "2024-01-01T00:00:00Z",
  "endDate": "2024-01-31T23:59:59Z",
  "clientId": "uuid",
  "externalId": "external-invoice-123"
}

Required Fields

amount - Total amount of the invoice (maximum value: 100,000,000)
contractId - UUID of the associated contract
clientId - UUID of the associated client

Fields descriptions see here

Invoice Management

Response

InvoiceEntity Schema

Error

Error Schema

Example Usage

Create invoice

Bash

curl -X POST "https://integration-api.ram.syniotec.com/invoices/v1/invoices" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceId": "INV-2024-001",
    "date": "2024-01-15",
    "deadline": "2024-02-15",
    "amount": 5000.00,
    "status": "PENDING",
    "contractId": "123e4567-e89b-12d3-a456-426614174000",
    "clientId": "123e4567-e89b-12d3-a456-426614174001",
    "bookingIds": ["70d7f2cc-bea8-4e6d-85ec-c2c14295690f"],
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": "2024-01-31T23:59:59Z",
    "externalId": "external-invoice-123"
  }'