Submit Transactions

Single Transaction

Endpoint: POST /api/guardian/v1/transactions/

curl -X POST https://api.abacus.com/api/guardian/v1/transactions/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_jurisdiction": "ej123456-7890-abcd-ef12-34567890abcd",
    "invoice_number": "INV-2025-001",
    "invoice_date": "2025-01-15",
    "partner_name": "German Customer GmbH",
    "partner_country": "DE",
    "vat_number": "DE987654321",
    "net": "1000.00",
    "vat": "190.00",
    "gross": "1190.00",
    "vat_rate": "19.00",
    "vat_rate_type": "standard",
    "currency": "EUR",
    "reporting_period": "2025-01-01",
    "transaction_type_id": "tt123456-7890-abcd-ef12-34567890abcd",
    "source": "tax_engine_api"
  }'

Response:

{
  "id": "t1r2a3n4-s5a6-7890-ctio-n1234567890",
  "entity_jurisdiction": "ej123456-7890-abcd-ef12-34567890abcd",
  "invoice_number": "INV-2025-001",
  "partner_name": "German Customer GmbH",
  "net": "1000.00",
  "vat": "190.00",
  "gross": "1190.00",
  "validity_status": "valid",
  "compliance_status": "valid",
  "committed": true,
  "created_at": "2025-07-02T10:25:00Z"
}

Required Fields

Field	Description	Example
entity_jurisdiction	EJ ID from registration	ej123456-...
invoice_number	Unique invoice reference	INV-2025-001
invoice_date	Invoice date (YYYY-MM-DD)	2025-01-15
partner_name	Customer/supplier name	German Customer GmbH
partner_country	ISO country code	DE
net	Net amount (decimal)	1000.00
vat	VAT amount (decimal)	190.00
gross	Gross amount (decimal)	1190.00
vat_rate	VAT rate percentage	19.00
currency	ISO currency code	EUR
reporting_period	Period start date	2025-01-01
transaction_type_id	Transaction type UUID	See reference table
source	Source identifier	tax_engine_api

Transaction Types

Type	ID	Use Case
B2B Sales	tt-b2b-sales-001	Standard B2B sales within EU
B2C Sales	tt-b2c-sales-001	B2C sales within EU
Intra-EU Supplies	tt-intra-eu-001	Zero-rated intra-EU supplies
Import Services	tt-import-services-001	Services imported from outside EU

Get available types:

curl -X GET https://api.abacus.com/api/guardian/v1/transaction-types/ \
  -H "Authorization: Bearer YOUR_TOKEN"