{"info":{"name":"TrustBill Partner API","description":"ERP integrator collection for TrustBill /v1/partner/*.\n\nBefore you begin: set the three collection variables — `apiKey`, `apiSecret`, `connectionSecret` — from your ERP Partner dashboard and an SME's Connect page.\n\nEvery mutation ships a fresh `Idempotency-Key` via a pre-request script. If you replay a request without changing the key, the API replays the stored response — safe for retries.\n\nBulk endpoint: to recover from a partial failure, resend the ORIGINAL body (same items, same order, same batch key). Retrying a subset with a fresh index range would collide on per-item derived keys.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json","_postman_id":"trustbill-partner-v1"},"auth":{"type":"apikey","apikey":[{"key":"in","value":"header","type":"string"},{"key":"key","value":"X-API-Key","type":"string"},{"key":"value","value":"{{apiKey}}","type":"string"}]},"variable":[{"key":"baseUrl","value":"https://trustbill.ae/api","type":"string"},{"key":"apiKey","value":"erp_test_...","type":"string"},{"key":"apiSecret","value":"...","type":"string"},{"key":"connectionSecret","value":"tb_secret_...","type":"string"},{"key":"idempotencyKey","value":"","type":"string"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["pm.variables.set('idempotencyKey', (crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`));"]}}],"item":[{"name":"meta / ping","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/ping","host":["{{baseUrl}}"],"path":["v1","partner","ping"]}}},{"name":"meta / whoami","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/whoami","host":["{{baseUrl}}"],"path":["v1","partner","whoami"]}}},{"name":"validation / validate TRN","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/validate-trn?trn=100000000000000","host":["{{baseUrl}}"],"path":["v1","partner","validate-trn"],"query":[{"key":"trn","value":"100000000000000"}]}}},{"name":"customers / upsert","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"externalRef\": \"acme-2024-001\",\n  \"name\": \"ACME Trading LLC\",\n  \"kind\": \"buyer\",\n  \"country\": \"AE\",\n  \"trn\": \"100000000000000\",\n  \"email\": \"billing@acme.example\",\n  \"phone\": \"+971 4 000 0000\",\n  \"address\": {\n    \"line1\": \"Office 501, Building 5\",\n    \"city\": \"Dubai\",\n    \"emirate\": \"Dubai\",\n    \"country\": \"AE\"\n  }\n}"},"url":{"raw":"{{baseUrl}}/v1/partner/customers","host":["{{baseUrl}}"],"path":["v1","partner","customers"]}}},{"name":"customers / read","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/customers/acme-2024-001","host":["{{baseUrl}}"],"path":["v1","partner","customers","acme-2024-001"]}}},{"name":"invoices / submit","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"trn\": \"100000000000000\",\n  \"number\": \"INV-2026-0001\",\n  \"issueDate\": \"2026-09-16\",\n  \"dueDate\": \"2026-10-16\",\n  \"documentType\": \"tax_invoice\",\n  \"currency\": \"AED\",\n  \"seller\": {\n    \"name\": \"Your SME Legal Name\",\n    \"trn\": \"100000000000000\",\n    \"country\": \"AE\",\n    \"address\": {\n      \"line1\": \"Office 501, Al Fahim Tower\",\n      \"city\": \"Dubai\",\n      \"emirate\": \"Dubai\",\n      \"country\": \"AE\"\n    }\n  },\n  \"buyer\": {\n    \"name\": \"ACME Trading LLC\",\n    \"trn\": \"100000000000003\",\n    \"country\": \"AE\",\n    \"address\": {\n      \"line1\": \"Marina Plaza\",\n      \"city\": \"Dubai\",\n      \"emirate\": \"Dubai\",\n      \"country\": \"AE\"\n    }\n  },\n  \"lines\": [\n    {\n      \"description\": \"Consulting hours\",\n      \"quantity\": 10,\n      \"unitPrice\": 500,\n      \"vatRate\": 0.05,\n      \"taxCategory\": \"standard_5\",\n      \"unitOfMeasureCode\": \"HUR\",\n      \"itemType\": \"services\"\n    }\n  ]\n}"},"url":{"raw":"{{baseUrl}}/v1/partner/invoices","host":["{{baseUrl}}"],"path":["v1","partner","invoices"]}}},{"name":"invoices / list","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/invoices?limit=25","host":["{{baseUrl}}"],"path":["v1","partner","invoices"],"query":[{"key":"limit","value":"25"}]}}},{"name":"invoices / get by id","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/invoices/{{invoiceId}}","host":["{{baseUrl}}"],"path":["v1","partner","invoices","{{invoiceId}}"]}}},{"name":"invoices / delete pre-delivery","request":{"method":"DELETE","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/invoices/{{invoiceId}}","host":["{{baseUrl}}"],"path":["v1","partner","invoices","{{invoiceId}}"]}}},{"name":"invoices / retry","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}"},"url":{"raw":"{{baseUrl}}/v1/partner/invoices/{{invoiceId}}/retry","host":["{{baseUrl}}"],"path":["v1","partner","invoices","{{invoiceId}}","retry"]}}},{"name":"invoices / bulk submit","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"},{"key":"Idempotency-Key","value":"{{idempotencyKey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"invoices\": [\n    {\n      \"externalRef\": \"acme-batch-1\",\n      \"trn\": \"100000000000000\",\n      \"number\": \"INV-2026-1001\",\n      \"issueDate\": \"2026-09-16\",\n      \"currency\": \"AED\",\n      \"seller\": {\n        \"name\": \"Your SME Legal Name\",\n        \"trn\": \"100000000000000\",\n        \"country\": \"AE\",\n        \"address\": {\n          \"line1\": \"Office 501, Al Fahim Tower\",\n          \"city\": \"Dubai\",\n          \"emirate\": \"Dubai\",\n          \"country\": \"AE\"\n        }\n      },\n      \"buyer\": {\n        \"name\": \"ACME\",\n        \"trn\": \"100000000000003\",\n        \"country\": \"AE\",\n        \"address\": {\n          \"line1\": \"Marina Plaza\",\n          \"city\": \"Dubai\",\n          \"emirate\": \"Dubai\",\n          \"country\": \"AE\"\n        }\n      },\n      \"lines\": [\n        {\n          \"description\": \"Item\",\n          \"quantity\": 1,\n          \"unitPrice\": 100,\n          \"vatRate\": 0.05,\n          \"unitOfMeasureCode\": \"EA\",\n          \"itemType\": \"goods\"\n        }\n      ]\n    }\n  ]\n}"},"url":{"raw":"{{baseUrl}}/v1/partner/invoices/bulk","host":["{{baseUrl}}"],"path":["v1","partner","invoices","bulk"]}}},{"name":"webhooks / replay","request":{"method":"POST","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/invoices/{{invoiceId}}/replay-webhook","host":["{{baseUrl}}"],"path":["v1","partner","invoices","{{invoiceId}}","replay-webhook"]}}},{"name":"webhooks / delivery audit trail","request":{"method":"GET","header":[{"key":"X-API-Key","value":"{{apiKey}}"},{"key":"X-API-Secret","value":"{{apiSecret}}"},{"key":"x-erp-partner-secret","value":"{{connectionSecret}}"}],"url":{"raw":"{{baseUrl}}/v1/partner/invoices/{{invoiceId}}/webhook-deliveries","host":["{{baseUrl}}"],"path":["v1","partner","invoices","{{invoiceId}}","webhook-deliveries"]}}}]}