ZATCA Submission Report

Production

GET

/api2/reports/e_invoices_submission

Every non-draft invoice, refund receipt, credit note and advance payment in the window, with its submission status, paid and unpaid figures and tax, grouped as the page groups them, with subtotals and totals as the page prints them. Refund receipts and credit notes carry negative figures.

Mirrors /owner/reports/report/e_invoices_submission and backs the ZATCA Submission Report card on the Sales tab. Answers 403 on an account without the Saudi e-invoicing plugin.

Request

Authorization

OAuth 2.0

Password

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://www.daftra.com/v2/oauth/token

API Key

Add parameter in header

apikey

Example:

apikey: ********************

API Key

Add parameter in cookie

OISystem

Example:

OISystem: ********************

Query Params

Header Params

Responses

🟢200

application/json

The report.

Bodyapplication/json

🟠400Error400

🟠401Error401

🟠403Error403

🟠404Error404

🟠405Error405

🔴500Error500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api2/reports/e_invoices_submission?date_from=2026-06-14&date_to=2026-06-16&date_type=&client_id=&e_invoice_status=&client_type=&branch_id=&currency=&group_by=' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'apikey: ' \
--header 'Content-Type: application/json'

Response Example

200 - Example 1

{
    "result": "successful",
    "code": 200,
    "data": {
        "report": {
            "key": "e_invoices_submission",
            "title": "string",
            "group_by": "string",
            "base_currency": "string",
            "consolidated": true
        },
        "filters": {
            "date_from": "2019-08-24",
            "date_to": "2019-08-24",
            "date_type": "created",
            "client_id": [
                0
            ],
            "e_invoice_status": "string",
            "client_type": 0,
            "branch_id": [
                0
            ],
            "currency": "string",
            "group_by": "string"
        },
        "columns": [
            {
                "key": "string",
                "label": "string",
                "currency_suffixed": true
            }
        ],
        "currencies": [
            {
                "currency": "string",
                "totals": {
                    "summary_total": 0,
                    "summary_paid": 0,
                    "summary_unpaid": 0,
                    "tax": 0
                },
                "groups": [
                    {
                        "key": "string",
                        "label": "string",
                        "subtotals": {
                            "summary_total": 0,
                            "summary_paid": 0,
                            "summary_unpaid": 0,
                            "tax": 0
                        },
                        "invoices": [
                            {
                                "id": 0,
                                "no": "string",
                                "type": 0,
                                "type_label": "string",
                                "date": "2019-08-24",
                                "issue_date": "string",
                                "submission_date": "string",
                                "submission_date_label": "string",
                                "client": "string",
                                "client_type": 2,
                                "client_type_label": "string",
                                "summary_total": 0,
                                "summary_paid": 0,
                                "summary_unpaid": 0,
                                "tax": 0,
                                "e_invoice_status": "string",
                                "e_invoice_status_label": "string",
                                "branch": "string",
                                "currency_code": "string"
                            }
                        ]
                    }
                ]
            }
        ],
        "meta": {
            "currency_count": 0,
            "group_count": 0,
            "invoice_count": 0,
            "conversion_rates": {
                "property1": {
                    "property1": 0,
                    "property2": 0
                },
                "property2": {
                    "property1": 0,
                    "property2": 0
                }
            }
        }
    }
}

Invoice Net Position Report

Product Sales Report