EU VAT Transaction Example

This example demonstrates how to submit a complete EU VAT transaction using the Guardian API.

Scenario

A German company is selling goods to a business customer in Germany. The transaction includes:

• Net amount: €1,000.00
• VAT (19%): €190.00
• Gross amount: €1,190.00

Prerequisites

• Valid OAuth2 token
• Entity jurisdiction ID for Germany
• Transaction type ID for B2B sales

Request

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": "tt-b2b-sales-001",
    "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"
}

Key Points

1. VAT Calculation: The VAT amount (€190.00) is calculated as 19% of the net amount (€1,000.00)
2. German VAT Number: The format DE987654321 is used for German VAT registration
3. Reporting Period: Set to the first day of the month for monthly reporting
4. Transaction Type: B2B sales type is used for business-to-business transactions

Next Steps

After successfully submitting the transaction:

1. The transaction will be included in the next filing for the reporting period
2. You can monitor the filing status using the Monitor Status workflow
3. Download the completed VAT return using the Filings API