Bulk Invoice Validation

POST https://api.beelpoint.com/v1/api/invoices/bulk

Headers

NOTE: Content-type must be application/json

Name	Type	Description
authorization*	String	API Secret Key

Request Body

Field	Type	Description
invoices	Object[]	Array of invoice objects to process.
business_id	String	The business external ID.
irn	String	The invoice reference number.
issue_date	Date	The date the invoice was issued (YYYY-MM-DD).
invoice_type_code	String	The type code of the invoice.
document_currency_code	String	The currency code (e.g., "NGN").
accounting_supplier_party	Object	Supplier party details.
tin	String	Supplier's TIN (required).
email	String	Supplier's email (required).
accounting_customer_party	Object	Customer party details.
tin	String	Customer's TIN (required).
email	String	Customer's email (required).
tax_total	Object[]	Array of tax totals (required).
legal_monetary_total	Object	Total monetary details (required).
invoice_line	Object[]	Array of invoice lines (required).

Bulk Invoice Validation Sample Request

{
    "invoices": [
        {
            "business_id": "2690117a-eb18-44ef-ba6b-a9e8f3d1c5f4",
            "irn": "IVN-2025-005-2C9GHT18-20251013",
            "issue_date": "2025-09-29",
            "due_date": "2025-10-29",
            "document_currency_code": "NGN",
            "payment_status": "PENDING",
            "invoice_type_code": "384",
            "tax_currency_code": "NGN",
            "accounting_supplier_party": {
                "party_name": "Telepac Africa Nigeria Limited",
                "tin": "15742708-0001",
                "email": "[email protected]",
                "telephone": "[phone]",
                "postal_address": {
                    "street_name": "Borno Way",
                    "city_name": "Yaba",
                    "postal_zone": "101283",
                    "country": "NG"
                }
            },
            "accounting_customer_party": {
                "party_name": "Silicon System Limited",
                "tin": "15742708-0001",
                "email": "[email protected]",
                "telephone": "[phone]",
                "postal_address": {
                    "street_name": "17 Akobi Crescent ",
                    "city_name": "Yaba",
                    "postal_zone": "101283",
                    "country": "NG"
                }
            },
            "legal_monetary_total": {
                "line_extension_amount": 720000,
                "tax_exclusive_amount": 720000,
                "tax_inclusive_amount": "720000.00",
                "payable_amount": "720000.00"
            },
            "note": "Pls pay within the time limit",
            "invoice_line": [
                {
                    "hsn_code": "1109.00",
                    "product_category": "Electronics",
                    "invoiced_quantity": "15",
                    "line_extension_amount": 720000,
                    "item": {
                        "name": "kitchen utensils",
                        "description": "1 pot set"
                    },
                    "price": {
                        "price_amount": "48000",
                        "base_quantity": "15",
                        "price_unit": "57589"
                    }
                }
            ],
            "tax_total": [
                {
                    "tax_amount": 720000,
                    "tax_subtotal": [
                        {
                            "taxable_amount": "720000.00",
                            "tax_amount": "0",
                            "tax_category": {
                                "id": "ZERO_GST",
                                "percent": 0
                            }
                        },
                        {
                            "taxable_amount": "720000.00",
                            "tax_amount": "0",
                            "tax_category": {
                                "id": "ZERO_VAT",
                                "percent": 0
                            }
                        },
                        {
                            "taxable_amount": "720000.00",
                            "tax_amount": "0",
                            "tax_category": {
                                "id": "ALCOHOL_EXCISE_TAX",
                                "percent": 0
                            }
                        },
                        {
                            "taxable_amount": "720000.00",
                            "tax_amount": "0",
                            "tax_category": {
                                "id": "IMPORT_DUTY",
                                "percent": 0
                            }
                        }
                    ]
                }
            ],
            "customer_id": "68c03ed93f2f7b0c5a617e2a",
            "paymentDetails": {
                "accountName": "Telepac Africa Nigeria Limited",
                "accountNumber": "7046834559",
                "bankName": "HSBC"
            },
            "subject": "This entity is into sales of provisions",
            "invoiceNumber": "90593480294",
            "invoiceCategory": "Business 2 Customer (B2C)"
        }
    ]
}

Succes Response

{
  "success": true,
  "status_code": 200,
  "message": "Bulk validation completed with 2 errors",
  "data": {
    "summary": {
      "totalProcessed": 10,
      "totalValidated": 8,
      "totalValidationErrors": 2
    },
    "details": {
      "validatedInvoices": [
        {"invoiceId": "6704fbf45339e28ca298a9cb", "irn": "INV-001"},
        ...
      ],
      "validationErrors": [
        {
          "irn": "INV-002",
          "errors": [
            {"field": "tax_total", "message": "Tax amount is required"}
          ]
        }
      ]
    }
  }
}

Other Error Response

{
  "success": false,
  "status_code": 400,
  "message": "Request body must contain an array of invoices"
}