---
title: "Report a debit note"
method: POST
path: "/zatca/simplified-debit-notes/report/"
tags: ["Simplified Debit Note"]
---

# Report a debit note

`POST /zatca/simplified-debit-notes/report/`

Reports a single debit note. Optionally, send the debit note using specified `channels`.

## Headers

- `X-ZATCA-Branch` string
- `X-ZATCA-Connected-Account-Id` string
- `X-ZATCA-Environment` string, required

## Request body

- ApiV1ZatcaSimplifiedDebitNoteReportWrite
  - `channels` Channel[] — The channels to send the document
    - `data` Email, required
      - `message` string, required
      - `recipients` EmailRecipients, required
        - `bcc` string[]
        - `cc` string[]
        - `to` string[], required
      - `subject` string, required
    - `medium` 'email', required — * `email` - Email Full information for [MediumEnum](mediumenum)
  - `document` ApiV1ZatcaSimplifiedDebitNoteReportDocumentWrite, required
    - `charges` ApiV1ZatcaDocumentReportChargeWrite[] — Charges applied to the document
      - `amount` number, double — The amount of the discount or charge
      - `base_amount` number, double — The amount on which the charge percentage is applied
      - `percent` number, double — The percent of the charge
      - `reason` 'AA' | 'AAA' | 'AAC' | 'AAD' | 'AAE' | 'AAF' | 'AAH' | 'AAI' | 'AAS' | 'AAT' | 'AAV' | 'AAY' | 'AAZ' | 'ABA' | 'ABB' | 'ABC' | 'ABD' | 'ABF' | 'ABK' | 'ABL' | 'ABN' | 'ABR' | 'ABS' | 'ABT' | 'ABU' | 'ACF' | 'ACG' | 'ACH' | 'ACI' | 'ACJ' | 'ACK' | 'ACL' | 'ACM' | 'ACS' | 'ADC' | 'ADE' | 'ADJ' | 'ADK' | 'ADL' | 'ADM' | 'ADN' | 'ADO' | 'ADP' | 'ADQ' | 'ADR' | 'ADT' | 'ADW' | 'ADY' | 'ADZ' | 'AEA' | 'AEB' | 'AEC' | 'AED' | 'AEF' | 'AEH' | 'AEI' | 'AEJ' | 'AEK' | 'AEL' | 'AEM' | 'AEN' | 'AEO' | 'AEP' | 'AES' | 'AET' | 'AEU' | 'AEV' | 'AEW' | 'AEX' | 'AEY' | 'AEZ' | 'AJ' | 'AU' | 'CA' | 'CAB' | 'CAD' | 'CAE' | 'CAF' | 'CAI' | 'CAJ' | 'CAK' | 'CAL' | 'CAM' | 'CAN' | 'CAO' | 'CAP' | 'CAQ' | 'CAR' | 'CAS' | 'CAT' | 'CAU' | 'CAV' | 'CAW' | 'CD' | 'CG' | 'CS' | 'CT' | 'DAB' | 'DAD' | 'DL' | 'EG' | 'EP' | 'ER' | 'FAA' | 'FAB' | 'FAC' | 'FC' | 'FH' | 'FI' | 'GAA' | 'HAA' | 'HD' | 'HH' | 'IAA' | 'IAB' | 'ID' | 'IF' | 'IR' | 'IS' | 'KO' | 'L1' | 'LA' | 'LAA' | 'LAB' | 'LF' | 'MAE' | 'MI' | 'ML' | 'NAA' | 'OA' | 'PA' | 'PAA' | 'PC' | 'PL' | 'RAB' | 'RAC' | 'RAD' | 'RAF' | 'RE' | 'RF' | 'RH' | 'RV' | 'SA' | 'SAA' | 'SAD' | 'SAE' | 'SAI' | 'SG' | 'SH' | 'SM' | 'SU' | 'TAB' | 'TAC' | 'TT' | 'TV' | 'V1' | 'V2' | 'WH' | 'XAA' | 'YY', required — * `AA` - Advertising * `AAA` - Telecommunication * `AAC` - Technical modification * `AAD` - Job-order production * `AAE` - Outlays * `AAF` - Off-premises * `AAH` - Additional processing * `AAI` - Attesting * `AAS` - Acceptance * `AAT` - Rush delivery * `...` Full information for [Reason725Enum](reason725enum)
      - `tax` ApiV1ZatcaDocumentReportTaxWrite, required
        - `exemption_reason` 'VATEX-SA-29' | 'VATEX-SA-29-7' | 'VATEX-SA-30' | 'VATEX-SA-32' | 'VATEX-SA-33' | 'VATEX-SA-34-1' | 'VATEX-SA-34-2' | 'VATEX-SA-34-3' | 'VATEX-SA-34-4' | 'VATEX-SA-34-5' | 'VATEX-SA-35' | 'VATEX-SA-36' | 'VATEX-SA-EDU' | 'VATEX-SA-HEA' | 'VATEX-SA-MLTRY' | 'VATEX-SA-OOS' — * `VATEX-SA-29` - [E] Article 29 * `VATEX-SA-29-7` - [E] Article 29 part 7 * `VATEX-SA-30` - [E] Article 30 * `VATEX-SA-32` - [Z] Article 32 * `VATEX-SA-33` - [Z] Article 33 * `VATEX-SA-34-1` - [Z] Article 34 part 1 * `VATEX-SA-34-2` - [Z] Article 34 part 2 * `VATEX-SA-34-3` - [Z] Article 34 part 3 * `VATEX-SA-34-4` - [Z] Article 34 part 4 * `VATEX-SA-34-5` - [Z] Article 34 part 5 * `...` Full information for [ExemptionReasonEnum](exemptionreasonenum)
        - `percent` number, double, required — The percent of the tax (e.g. 15)
        - `type` 'E' | 'O' | 'S' | 'Z', required — * `E` - Exempt from tax * `O` - Services outside the scope of tax * `S` - Standard rate * `Z` - Zero-rated goods Full information for [Api-v1-zatca-document-report-tax-writeTypeEnum](api-v1-zatca-document-report-tax-writetypeenum)
    - `currency` 'AED' | 'SAR' | 'USD' | 'EUR' | 'CAD' | 'AFN' | 'ALL' | 'AMD' | 'ARS' | 'AUD' | 'AZN' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BND' | 'BOB' | 'BRL' | 'BWP' | 'BYN' | 'BZD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'GBP' | 'GEL' | 'GHS' | 'GNF' | 'GTQ' | 'HKD' | 'HNL' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KHR' | 'KMF' | 'KRW' | 'KWD' | 'KZT' | 'LBP' | 'LKR' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MOP' | 'MUR' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SDG' | 'SEK' | 'SGD' | 'SOS' | 'SYP' | 'THB' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'UYU' | 'UZS' | 'VES' | 'VND' | 'XAF' | 'XOF' | 'YER' | 'ZAR' | 'ZMW', required — * `AED` - AED ⃱ * `SAR` - SAR ⃁ * `USD` - USD $ * `EUR` - EUR € * `CAD` - CAD $ * `AFN` - AFN ؋ * `ALL` - ALL Lek * `AMD` - AMD դր. * `ARS` - ARS $ * `AUD` - AUD $ * `...` Full information for [CurrencyEnum](currencyenum)
    - `customer` ApiV1ZatcaDocumentReportCustomerSimplifiedWrite, required
      - `address` ApiV1ZatcaDocumentReportPartyAddressSimplifiedWrite
        - `building` string — The number of the building
        - `city` string — The name of the city
        - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'AC' | 'CP' | 'CQ' | 'DG' | 'EA' | 'EU' | 'EZ' | 'FX' | 'IC' | 'SU' | 'TA' | 'UK' | 'UN', required — * `AD` - Andorra * `AE` - United Arab Emirates * `AF` - Afghanistan * `AG` - Antigua and Barbuda * `AI` - Anguilla * `AL` - Albania * `AM` - Armenia * `AO` - Angola * `AQ` - Antarctica * `AR` - Argentina * `...` Full information for [Country23dEnum](country23denum)
        - `district` string — The name of the district
        - `postal_code` string — The postal code of the address
        - `street` string — The name of the street
      - `identification` ApiV1ZatcaDocumentReportCustomerIdentificationWrite
        - `type` 'CRN' | 'GCC' | 'IQA' | 'MLS' | 'SAG' | 'MOM' | 'NAT' | '700' | 'OTH' | 'PAS' | 'TIN', required — * `CRN` - CR Number * `GCC` - GCC ID * `IQA` - Iqama number * `MLS` - MHRSD license * `SAG` - MISA license * `MOM` - MOMRAH license * `NAT` - National ID * `700` - Unified number * `OTH` - Other ID * `PAS` - Passport ID * `...` Full information for [Api-v1-zatca-document-report-customer-identification-writeTypeEnum](api-v1-zatca-document-report-customer-identification-writetypeenum)
        - `value` string, required — Value of the identification method
      - `name` string, required — The name of the customer
      - `tax_registration_number` string — The tax registration number of the customer
    - `discounts` ApiV1ZatcaDocumentReportDiscountWrite[] — Discounts applied to the document
      - `amount` number, double — The amount of the discount or charge
      - `base_amount` number, double — The amount on which the discount percentage is applied
      - `percent` number, double — The percent of the discount
      - `reason` '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '44' | '45' | '46' | '47' | '48' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '59' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '69' | '70' | '71' | '72' | '73' | '74' | '75' | '76' | '77' | '78' | '79' | '80' | '81' | '82' | '83' | '84' | '85' | '86' | '87' | '88' | '89' | '90' | '91' | '92' | '93' | '94' | '95' | '96' | '97' | '98' | '99' | '100' | '101' | '102' | '103' | '104' | '105', required — * `1` - Handling commission * `2` - Amendment commission * `3` - Acceptance commission * `4` - Commission for obtaining acceptance * `5` - Commission on delivery * `6` - Advising commission * `7` - Confirmation commission * `8` - Deferred payment commission * `9` - Commission for taking up documents * `10` - Opening commission * `...` Full information for [ReasonB27Enum](reasonb27enum)
      - `tax` ApiV1ZatcaDocumentReportTaxWrite, required
        - `exemption_reason` 'VATEX-SA-29' | 'VATEX-SA-29-7' | 'VATEX-SA-30' | 'VATEX-SA-32' | 'VATEX-SA-33' | 'VATEX-SA-34-1' | 'VATEX-SA-34-2' | 'VATEX-SA-34-3' | 'VATEX-SA-34-4' | 'VATEX-SA-34-5' | 'VATEX-SA-35' | 'VATEX-SA-36' | 'VATEX-SA-EDU' | 'VATEX-SA-HEA' | 'VATEX-SA-MLTRY' | 'VATEX-SA-OOS' — * `VATEX-SA-29` - [E] Article 29 * `VATEX-SA-29-7` - [E] Article 29 part 7 * `VATEX-SA-30` - [E] Article 30 * `VATEX-SA-32` - [Z] Article 32 * `VATEX-SA-33` - [Z] Article 33 * `VATEX-SA-34-1` - [Z] Article 34 part 1 * `VATEX-SA-34-2` - [Z] Article 34 part 2 * `VATEX-SA-34-3` - [Z] Article 34 part 3 * `VATEX-SA-34-4` - [Z] Article 34 part 4 * `VATEX-SA-34-5` - [Z] Article 34 part 5 * `...` Full information for [ExemptionReasonEnum](exemptionreasonenum)
        - `percent` number, double, required — The percent of the tax (e.g. 15)
        - `type` 'E' | 'O' | 'S' | 'Z', required — * `E` - Exempt from tax * `O` - Services outside the scope of tax * `S` - Standard rate * `Z` - Zero-rated goods Full information for [Api-v1-zatca-document-report-tax-writeTypeEnum](api-v1-zatca-document-report-tax-writetypeenum)
    - `document_number` string, required — The document number
    - `line_items` ApiV1ZatcaDocumentLineWrite[], required — Line items of the document
      - `charges` ApiV1ZatcaDocumentReportLineChargeWrite[] — Charges applied to the line item
        - `amount` number, double — The amount of the discount or charge
        - `base_amount` number, double — The amount on which the charge percentage is applied
        - `percent` number, double — The percent of the charge
        - `reason` 'AA' | 'AAA' | 'AAC' | 'AAD' | 'AAE' | 'AAF' | 'AAH' | 'AAI' | 'AAS' | 'AAT' | 'AAV' | 'AAY' | 'AAZ' | 'ABA' | 'ABB' | 'ABC' | 'ABD' | 'ABF' | 'ABK' | 'ABL' | 'ABN' | 'ABR' | 'ABS' | 'ABT' | 'ABU' | 'ACF' | 'ACG' | 'ACH' | 'ACI' | 'ACJ' | 'ACK' | 'ACL' | 'ACM' | 'ACS' | 'ADC' | 'ADE' | 'ADJ' | 'ADK' | 'ADL' | 'ADM' | 'ADN' | 'ADO' | 'ADP' | 'ADQ' | 'ADR' | 'ADT' | 'ADW' | 'ADY' | 'ADZ' | 'AEA' | 'AEB' | 'AEC' | 'AED' | 'AEF' | 'AEH' | 'AEI' | 'AEJ' | 'AEK' | 'AEL' | 'AEM' | 'AEN' | 'AEO' | 'AEP' | 'AES' | 'AET' | 'AEU' | 'AEV' | 'AEW' | 'AEX' | 'AEY' | 'AEZ' | 'AJ' | 'AU' | 'CA' | 'CAB' | 'CAD' | 'CAE' | 'CAF' | 'CAI' | 'CAJ' | 'CAK' | 'CAL' | 'CAM' | 'CAN' | 'CAO' | 'CAP' | 'CAQ' | 'CAR' | 'CAS' | 'CAT' | 'CAU' | 'CAV' | 'CAW' | 'CD' | 'CG' | 'CS' | 'CT' | 'DAB' | 'DAD' | 'DL' | 'EG' | 'EP' | 'ER' | 'FAA' | 'FAB' | 'FAC' | 'FC' | 'FH' | 'FI' | 'GAA' | 'HAA' | 'HD' | 'HH' | 'IAA' | 'IAB' | 'ID' | 'IF' | 'IR' | 'IS' | 'KO' | 'L1' | 'LA' | 'LAA' | 'LAB' | 'LF' | 'MAE' | 'MI' | 'ML' | 'NAA' | 'OA' | 'PA' | 'PAA' | 'PC' | 'PL' | 'RAB' | 'RAC' | 'RAD' | 'RAF' | 'RE' | 'RF' | 'RH' | 'RV' | 'SA' | 'SAA' | 'SAD' | 'SAE' | 'SAI' | 'SG' | 'SH' | 'SM' | 'SU' | 'TAB' | 'TAC' | 'TT' | 'TV' | 'V1' | 'V2' | 'WH' | 'XAA' | 'YY', required — * `AA` - Advertising * `AAA` - Telecommunication * `AAC` - Technical modification * `AAD` - Job-order production * `AAE` - Outlays * `AAF` - Off-premises * `AAH` - Additional processing * `AAI` - Attesting * `AAS` - Acceptance * `AAT` - Rush delivery * `...` Full information for [Reason725Enum](reason725enum)
      - `description` string, required — The description of the line item
      - `discounts` ApiV1ZatcaDocumentReportLineDiscountWrite[] — Discounts applied to the line item
        - `amount` number, double — The amount of the discount or charge
        - `base_amount` number, double — The amount on which the discount percentage is applied
        - `percent` number, double — The percent of the discount
        - `reason` '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '44' | '45' | '46' | '47' | '48' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '59' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '69' | '70' | '71' | '72' | '73' | '74' | '75' | '76' | '77' | '78' | '79' | '80' | '81' | '82' | '83' | '84' | '85' | '86' | '87' | '88' | '89' | '90' | '91' | '92' | '93' | '94' | '95' | '96' | '97' | '98' | '99' | '100' | '101' | '102' | '103' | '104' | '105', required — * `1` - Handling commission * `2` - Amendment commission * `3` - Acceptance commission * `4` - Commission for obtaining acceptance * `5` - Commission on delivery * `6` - Advising commission * `7` - Confirmation commission * `8` - Deferred payment commission * `9` - Commission for taking up documents * `10` - Opening commission * `...` Full information for [ReasonB27Enum](reasonb27enum)
      - `item` string, required — The name of the line item
      - `quantity` number, double, required — The quantity of the line item
      - `tax` ApiV1ZatcaDocumentReportTaxWrite, required
        - `exemption_reason` 'VATEX-SA-29' | 'VATEX-SA-29-7' | 'VATEX-SA-30' | 'VATEX-SA-32' | 'VATEX-SA-33' | 'VATEX-SA-34-1' | 'VATEX-SA-34-2' | 'VATEX-SA-34-3' | 'VATEX-SA-34-4' | 'VATEX-SA-34-5' | 'VATEX-SA-35' | 'VATEX-SA-36' | 'VATEX-SA-EDU' | 'VATEX-SA-HEA' | 'VATEX-SA-MLTRY' | 'VATEX-SA-OOS' — * `VATEX-SA-29` - [E] Article 29 * `VATEX-SA-29-7` - [E] Article 29 part 7 * `VATEX-SA-30` - [E] Article 30 * `VATEX-SA-32` - [Z] Article 32 * `VATEX-SA-33` - [Z] Article 33 * `VATEX-SA-34-1` - [Z] Article 34 part 1 * `VATEX-SA-34-2` - [Z] Article 34 part 2 * `VATEX-SA-34-3` - [Z] Article 34 part 3 * `VATEX-SA-34-4` - [Z] Article 34 part 4 * `VATEX-SA-34-5` - [Z] Article 34 part 5 * `...` Full information for [ExemptionReasonEnum](exemptionreasonenum)
        - `percent` number, double, required — The percent of the tax (e.g. 15)
        - `type` 'E' | 'O' | 'S' | 'Z', required — * `E` - Exempt from tax * `O` - Services outside the scope of tax * `S` - Standard rate * `Z` - Zero-rated goods Full information for [Api-v1-zatca-document-report-tax-writeTypeEnum](api-v1-zatca-document-report-tax-writetypeenum)
      - `unit_of_measure` string — The unit of measure of the line item
      - `unit_price` number, double, required — The price of the line item per unit amount
    - `note` string — Additional information about the document
    - `payment_means` ApiV1ZatcaDocumentReportPaymentMeansRequiredWrite, required
      - `account_id` string — The account number, IBAN, to which the transfer should be made. In the case of factoring this account is owned by the factor.
      - `code` '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '31' | '32' | '33' | '34' | '35' | '36' | '37' | '38' | '39' | '40' | '41' | '42' | '43' | '44' | '45' | '46' | '47' | '48' | '49' | '50' | '51' | '52' | '53' | '54' | '55' | '56' | '57' | '58' | '59' | '60' | '61' | '62' | '63' | '64' | '65' | '66' | '67' | '68' | '70' | '74' | '75' | '76' | '77' | '78' | '91' | '92' | '93' | '94' | '95' | '96' | '97', required — * `1` - Instrument not defined * `2` - Automated clearing house credit * `3` - Automated clearing house debit * `4` - ACH demand debit reversal * `5` - ACH demand credit reversal * `6` - ACH demand credit * `7` - ACH demand debit * `8` - Hold * `9` - National or regional clearing * `10` - In cash * `...` Full information for [Code7a1Enum](code7a1enum)
      - `issue_reason` string, required — The reason for issuing the document
      - `payment_terms` string — The payment terms, if mode of payment is credit. Free text
    - `prepayments` ApiV1ZatcaDocumentPrepaymentLineWrite[] — Pre-payments used to partially pay this document
      - `amount` number, double, required — The amount from prepayment used at this tax rate
      - `issue_datetime` string, date-time, required — The issue datetime in UTC of the prepayment. Acts as a fallback for prepayments that were not reported.
      - `reference` string, required — The prepayment invoice number
      - `tax` ApiV1ZatcaDocumentReportTaxWrite, required
        - `exemption_reason` 'VATEX-SA-29' | 'VATEX-SA-29-7' | 'VATEX-SA-30' | 'VATEX-SA-32' | 'VATEX-SA-33' | 'VATEX-SA-34-1' | 'VATEX-SA-34-2' | 'VATEX-SA-34-3' | 'VATEX-SA-34-4' | 'VATEX-SA-34-5' | 'VATEX-SA-35' | 'VATEX-SA-36' | 'VATEX-SA-EDU' | 'VATEX-SA-HEA' | 'VATEX-SA-MLTRY' | 'VATEX-SA-OOS' — * `VATEX-SA-29` - [E] Article 29 * `VATEX-SA-29-7` - [E] Article 29 part 7 * `VATEX-SA-30` - [E] Article 30 * `VATEX-SA-32` - [Z] Article 32 * `VATEX-SA-33` - [Z] Article 33 * `VATEX-SA-34-1` - [Z] Article 34 part 1 * `VATEX-SA-34-2` - [Z] Article 34 part 2 * `VATEX-SA-34-3` - [Z] Article 34 part 3 * `VATEX-SA-34-4` - [Z] Article 34 part 4 * `VATEX-SA-34-5` - [Z] Article 34 part 5 * `...` Full information for [ExemptionReasonEnum](exemptionreasonenum)
        - `percent` number, double, required — The percent of the tax (e.g. 15)
        - `type` 'E' | 'O' | 'S' | 'Z', required — * `E` - Exempt from tax * `O` - Services outside the scope of tax * `S` - Standard rate * `Z` - Zero-rated goods Full information for [Api-v1-zatca-document-report-tax-writeTypeEnum](api-v1-zatca-document-report-tax-writetypeenum)
    - `reference_document_number` string, required — The document number of the document that is being debited
    - `supplier` ApiV1ZatcaDocumentReportSupplierWrite, required
      - `address` ApiV1ZatcaDocumentReportPartyAddressWrite, required
        - `building` string, required — The number of the building
        - `city` string, required — The name of the city
        - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'AC' | 'CP' | 'CQ' | 'DG' | 'EA' | 'EU' | 'EZ' | 'FX' | 'IC' | 'SU' | 'TA' | 'UK' | 'UN', required — * `AD` - Andorra * `AE` - United Arab Emirates * `AF` - Afghanistan * `AG` - Antigua and Barbuda * `AI` - Anguilla * `AL` - Albania * `AM` - Armenia * `AO` - Angola * `AQ` - Antarctica * `AR` - Argentina * `...` Full information for [Country23dEnum](country23denum)
        - `district` string, required — The name of the district
        - `postal_code` string, required — The postal code of the address
        - `street` string, required — The name of the street
      - `identification` ApiV1ZatcaDocumentReportSupplierIdentificationWrite, required
        - `type` 'CRN' | 'MLS' | 'SAG' | 'MOM' | '700' | 'OTH', required — * `CRN` - CR Number * `MLS` - MHRSD license * `SAG` - MISA license * `MOM` - MOMRAH license * `700` - Unified number * `OTH` - Other ID Full information for [Api-v1-zatca-document-report-supplier-identification-writeTypeEnum](api-v1-zatca-document-report-supplier-identification-writetypeenum)
        - `value` string, required — Value of the identification method
      - `name` string, required — The name of the supplier
    - `supply_date` string, date, required — The date of the product or service was supplied
    - `tax_amount_type` 'E' | 'I' — * `E` - Exclusive * `I` - Inclusive Full information for [TaxAmountTypeEnum](taxamounttypeenum)
    - `tax_total` number, double — The tax total amount in SAR currency
  - `language` 'ar' | 'en' — * `ar` - Arabic * `en` - English Full information for [LanguageEnum](languageenum)
  - `metadata` object — The metadata of the document
  - `reference` string — The reference of the document
  - `template` ApiV1ZatcaDocumentSendTemplateWrite
    - `config` ApiV1ZatcaDocumentSendTemplateConfigWrite
      - `charges` ApiV1ZatcaDocumentSendTemplateConfigAllowancesWrite[] — Configuration for charges provided
        - `labels` ApiV1ZatcaDocumentSendTemplateConfigAllowancesLabelsWrite, required
          - `ar` string, required
          - `en` string, required
        - `reasons` string[], required
      - `discounts` ApiV1ZatcaDocumentSendTemplateConfigAllowancesWrite[] — Configuration for discounts provided
        - `labels` ApiV1ZatcaDocumentSendTemplateConfigAllowancesLabelsWrite, required
          - `ar` string, required
          - `en` string, required
        - `reasons` string[], required
    - `context` unknown
    - `id` string — The id of the custom template to be used for PDF generation

## Response `201`

The document was created and reported/cleared to ZATCA successfully

- DocumentDetailRead
  - `created_ts` string, date-time, required — The datetime in UTC when the document was created.
  - `document` ApiV1ZatcaDocumentDetailRead, required
    - `document_number` string, required — The document number.
    - `id` string, required — The id of the object.
    - `issue_datetime` string, date-time, required — The issue datetime.
    - `supply_date` string, date, required — The supply date.
  - `metadata` object, required — The metadata of the document.
  - `qr_code_data` string, required — Base64 encoded QR code data.
  - `reference` string, required — The reference of the document.
  - `reported_ts` string, date-time, required — The datetime in UTC when the document was reported/cleared.
  - `response` unknown, required
  - `sent_ts` string, date-time, required — The datetime in UTC when the document was sent.
  - `status` string, required — The status of the document.

## Other responses

- `400` — The request was invalid or did not pass ZATCA validation rules
- `403` — No active device found, environment header is missing or invalid
- `424` — The request for reporting/clearing to ZATCA failed
- `500` — Unexpected error occurred while processing the request

---

[API](https://skmtc.net/wafeq/apis/wafeq-zatca-api.md) · [All operations](https://skmtc.net/wafeq/apis/wafeq-zatca-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wafeq/wafeq-zatca-api/versions/b1556963edcd/schema)