# E-Invoice

### If supply is made through E-Commerce then GSTIN of E-Commerce operator can be mentioned hereGuidelines

Below are some of the points you must be aware of while calling Payouts APIs:

* All API requests and responses are in JSON format.
* POST requests should include `ContentType: application/json`&#x20;
* All API response have **status,  message,** and **data**.
* Swipez uses API keys to allow access to the API. Once you have signed up at our merchant site, you will be able to see your [AccessKey and SecretKey](https://www.swipez.in/merchant/profile/accesskey).

### Quick Refer

### **Authentication**

Calling the Authentication APIs allows you to get and verify bearer tokens returned by Swipez. Swipez require these token for all further communication.

> * Swipez libraries automatically call the Authorize API and internally store the token.
>
> * Do not store the token in an insecure manner. Regenerating a new token does not invalidate the already generated token. Token generated from one IP address cannot be used from a different IP address.
>
> * Token generated is valid for 60 Min . Please ensure that you get a new token by calling the authorize API once the token has expired.

### Rate limiting

The API is rate limited per user. You will receive a 429 HTTP status code if you exceed the rate limit. The rate limit is 30 requests per minute per user and is subject to change.

## Get token

<mark style="color:green;">`POST`</mark> `/api/token`

This endpoint allows you to get API token.

#### Request Body

| Name                | Type   | Description      |
| ------------------- | ------ | ---------------- |
| access\_key\_id     | string | Your access key. |
| secret\_access\_key | string | Your secret key. |

{% tabs %}
{% tab title="200 " %}

```
{
    "success": {
        "token": "<GENERATED TOEKN>"
    }
}
```

{% endtab %}

{% tab title="401 " %}

```
{
    "error": "Invalid Keys",
    "status": 0
}
```

{% endtab %}
{% endtabs %}

#### Sample code

{% tabs %}
{% tab title="CURL" %}

```javascript
curl --location --request POST '<BASE URL>/api/token' \
--form 'access_key_id="<GET ACCESS KEY ID FROM YOUR ACCOUNT>"' \
--form 'secret_access_key="<GET SECRET ACCESS KEY FROM YOUR ACCOUNT>"'


```

{% endtab %}

{% tab title="PHP" %}

```
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '<BASE URL>/api/token',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('access_key_id' => '<GET ACCESS KEY ID FROM YOUR ACCOUNT>','secret_access_key' => '<GET SECRET ACCESS KEY FROM YOUR ACCOUNT>'),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

```

{% endtab %}
{% endtabs %}

## Save E-invoice

<mark style="color:green;">`POST`</mark> `/api/v1/einvoice/save`

This endpoint allows you to add E-invoice.

#### Headers

| Name          | Type   | Description       |
| ------------- | ------ | ----------------- |
| Authorization | string | Bearer auth token |
| Content-Type  | string | application/json  |

#### Request Body

| Name                                         | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| userGstin<mark style="color:red;">\*</mark>  | String | GSTIN of the entity initiating E-Invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| pobCode                                      | String | <p>"This field represents the POB Name for which the user has been given access to initiate any E-Invoice operation.</p><p>In case of einvoice, if a POB has been added then, the user has to provide POB in this column. However if POB has not been added, then POB field will be blank"</p>                                                                                                                                                                                                                                                |
| supplyType<mark style="color:red;">\*</mark> | String | Type of supply whether it is outward/inward. Inward supply is allowed only for E-way bill generation purposes                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ntr<mark style="color:red;">\*</mark>        | String | Nature of transaction i.e. whether Inter/Intra                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| docType<mark style="color:red;">\*</mark>    | String | "Type of documents. RI - Regular Invoice (Tax Invoice) C - Credit Note D - Debit Note BS - Bill of Supply BOE - Bill of Entry DC - Delivery Challan OTH - Others"                                                                                                                                                                                                                                                                                                                                                                             |
| catg<mark style="color:red;">\*</mark>       | String | "B2B - Regular B2B Invoices of registered counterparty B2CL - Regular B2CL invoices (Interstate supplies to unregistered dealers or consumers>2.5 lakhs) B2CS - Other than B2CL (unregistered counterparty and consumers) SEWOP – SEZ exports without payment SEWP – SEZ Exports with payment DE – Deemed Exports EXWP - Export with payment of duty EXWOP - Export without payment of duty IMG - Import of Goods OTH - Others"                                                                                                               |
| dst<mark style="color:red;">\*</mark>        | String | "Status of Document if O - Original, R -Revised"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| trnTyp<mark style="color:red;">\*</mark>     | String | Type of transaction is required to identify the type of movement of goods. Whether it is Regular movement or "Bill to - Ship To" movement or "Bill From - Dispatch From" movement or "Bill To - Ship To and Bill From - Dispatch From" movement.                                                                                                                                                                                                                                                                                              |
| no<mark style="color:red;">\*</mark>         | String | <p>"In case of regular invoice, the invoice number is to be provided. It will be as per invoice number rule mentioned in CGST/SGST rule</p><p>Debit/Credit Note number also to be captured here"</p>                                                                                                                                                                                                                                                                                                                                          |
| dt<mark style="color:red;">\*</mark>         | String | In case of regular invoice, this is the invoice date. In case of credit/ debit note, this is date on which the credit / debit note is issued.                                                                                                                                                                                                                                                                                                                                                                                                 |
| refinum                                      | String | Original Invoice Number in case of Credit / Debit note                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| refidt                                       | String | This differential percentage was applicable only till 30th June 2020 and hence it’s a field that is no longer required                                                                                                                                                                                                                                                                                                                                                                                                                        |
| rchrg                                        | String | Whether reverse charge is applicable Y or N                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| pos                                          | String | This is place of supply as per rules. Please refer to state codes in Meta Data Codes sheet                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| diffprcnt                                    | String | This differential percentage was applicable only till 30th June 2020 and hence it’s a field that is no longer required                                                                                                                                                                                                                                                                                                                                                                                                                        |
| etin                                         | String |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| sgstin                                       | String | "GSTIN of the Supplier. In case user is registered as a normal taxpayer and supply type is outward then this needs to be same as the User GSTIN In case user is registered as a ecommerce operator and supply type is outward then this will be different from User GSTIN whereas In case of inward supplies this can be 15 digit GSTIN or URP in case the supplier is unregistered."                                                                                                                                                         |
| strdNm                                       | String | Address 1 of the Supplier.(Building/Flat no., Road/Street etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| slglNm                                       | String | Legal Name as appearing in PAN of the Supplier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| sbnm                                         | String | Address 1 of the Supplier.(Building/Flat no., Road/Street etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| sflno                                        | String | "Address 2 of the Supplier(Floor no., Name of the premises/building) "                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| sloc                                         | String | Location of the Supplier (City/Town/Village etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| sdst                                         | String | District in which location of supplier is present                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| sstcd                                        | String | State code of the state where the location of supplier is present                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| spin                                         | String | Pin code of supplier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| sph                                          | String | Phone number/Mobile number of supplier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| sem                                          | String | Email id of supplier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| bgstin                                       | String | GSTIN of Buyer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| btrdNm                                       | String | Trade name of buyerLegal Name as appearing in PAN of the Buyer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| blglNm                                       | String | Legal Name as appearing in PAN of the Buyer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| bbnm                                         | String | Address 1 of the Buyer.(Building/Flat no., Road/Street etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| bflno                                        | String | "Address 2 of the Buyer(Floor no., Name of the premises/building) "                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| bloc                                         | String | Location of the Buyer (City/Town/Village etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| bdst                                         | String | District in which location of buyer is present                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| bstcd                                        | String | State code of the state where the location of buyer is present                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| bpin                                         | String | Pin code of buyer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| bph                                          | String | Phone number/Mobile number of buyer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| bem                                          | String | Email id of buyer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| dgstin                                       | String | GSTIN of the person from where goods are dispatched                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| dtrdNm                                       | String | Name of the company from which goods are dispatched.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| dlglNm                                       | String | Legal Name of the entity who dispatch the goods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| dbnm                                         | String | " Address 1 of the entity from which goods are dispatched. (Building/Flat no., Road/Street etc.) "                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| dflno                                        | String | "Address 2 of the entity from which goods are dispatched. (Floor no., Name of the premises/building) "                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| dloc                                         | String | Location of the entity from which goods are dispatched.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ddst                                         | String | District of the entity from which goods are dispatched.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| dstcd                                        | String | State code of the entity from which goods are dispatched.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| dpin                                         | String | PIN code of the place of entity from where goods are dispatched.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| dph                                          | String | Phone number/mobile number of the party who dispatch the goods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| dem                                          | String | Email ID of the party who dispatch the goods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| togstin                                      | String | GSTIN of the entity to whom goods are shipped to                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| totrdNm                                      | String | Trade name of the entity to whom the supplies are shipped to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| tolglNm                                      | String | Legal name of the entity to whom the supplies are shipped to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| tobnm                                        | String | Address1 of the entity to whom the supplies are shipped to. (Building/Flat no., Road/Street etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| toflno                                       | String | Address 2 of the entity to whom the supplies are shipped to. (Floor no., Name of the premises/building)                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| toloc                                        | String | Place of entity to whom the supplies are shipped to. (City/Town/Village etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| todst                                        | String | District of the entity to whom goods are shipped to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| tostcd                                       | String | State code to which the supplies are shipped to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| topin                                        | String | PIN code of the location to which the supplies are shipped to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| toph                                         | String | Phone number/Mobile number of the entity to whom goods are shipped to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| toem                                         | String | Email ID of the entity to whom goods are shipped to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| sbnum                                        | String | Shipping bill number of the goods exported                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| sbdt                                         | String | Shipping bill date of the goods exported                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| port                                         | String | Port code of the goods exported                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| cntcd                                        | String | Country to which goods are exported, also applicable in case of export of services                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| forCur                                       | String | Currency code of the foreign country to which goods/services are exported                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| invForCur                                    | String | The total amount of the Invoice in foreign currency                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| totinvval                                    | String | The total value of invoice including taxes/GST and rounded to two decimals maximum. This is required to be adjusted for invoice level other charges, discount and round off value provided in the invoice                                                                                                                                                                                                                                                                                                                                     |
| totdisc                                      | String | Sum of all discount/rebate/reductions on document level in the Invoice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| totfrt                                       | String | Freight Charges at Invoice Level                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| totins                                       | String | Insurance at Invoice Level                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| totothchrg                                   | String | Sum of all other charges on document level in the Invoice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| totpkg                                       | String | Packaging and Forwarding at Invoice Level                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| tottxval                                     | String | Total of assessable / taxable value of all line items of the invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| totiamt                                      | String | The IGST amount of all items of the invoice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| totcamt                                      | String | The CGST amount of all items of the invoice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| totsamt                                      | String | The SGST amount of all items of the invoice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| totcsamt                                     | String | This is total cess amount other than State cess including ad valorem as well as non ad valorem                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| totstcsamt                                   | String | This is total State cess amount that includes ad valorem as well as non ad valorem                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| rndOffAmt                                    | String | This is rounding off amount e.g. 0.21.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| num                                          | String | If an invoice (or a credit/ debit note) has multiple line items, kindly mention a unique serial number for each item, and include the details of each item in a new row separately. If you have only one item, mention Sr. No as 1                                                                                                                                                                                                                                                                                                            |
| prdNm                                        | String | Name of the product                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| prdDesc                                      | String | Description of Product                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| hsnCd                                        | String | <p>"HSN code is a 4 to 8 digit uniform code that classifies 5000+ products and is accepted worldwide.</p><p>For companies having turnover above 5cr for them it is mandatory to provide minimum 6 digit of HSN code."</p>                                                                                                                                                                                                                                                                                                                     |
| barcde                                       | String | if Bar code is maintained for any product, same can be reported in this field                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| qty                                          | String | The quantity of items (goods or services) that is charged in the Invoice line.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| freeQty                                      | String | Detail of any Free of Charge Quantity (FOC)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| unit                                         | String | The unit of measure that applies to the invoiced quantity.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| unitPrice                                    | String | The price of an item, exclusive of GST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| sval                                         | String | (Unit Price \* Quantity)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| disc                                         | String | Discount given on item level                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| othchrg                                      | String | Other charges applicable at item level                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| txval                                        | String | (Total Amount -Discount)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| rt                                           | String | The GST rate, represented as percentage that applies to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| irt                                          | String | The IGST rate, represented as percentage that applies to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| iamt                                         | String | IGST amount applicable to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| crt                                          | String | The CGST rate, represented as percentage that applies to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| camt                                         | String | CGST amount applicable to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| srt                                          | String | The SGST rate, represented as percentage that applies to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| samt                                         | String | SGST amount applicable to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| csrt                                         | String | The CESS rate, represented as percentage that applies to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| csamt                                        | String | CESS amount (advalorem) applicable to each line item of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| itmVal                                       | String | Sum total of all the taxes and taxable value and other charges in single line item : (taxable value + tax amounts+Other charges)                                                                                                                                                                                                                                                                                                                                                                                                              |
| txp                                          | String | "T - Taxable L - Nil E- Exempt N - Non GST F-Free Supplies"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| bchnm                                        | String | Batch number details if any can be mentioned here                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| bchExpDt                                     | String | Expiry date of goods/services can be mentioned here                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| bchWrDt                                      | String | Date of warranty of goods can be mentioned here                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| isServc                                      | String | Specify whether supply is service or not                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| preTaxVal                                    | String | If pre tax value is different from taxable value, mention the pre-tax value and taxable values separately. In some cases the pre-tax value may be different from taxable value. For example, where old goods are exchanged for new ones (e.g. new phone supplied for INR 20,000 along with exchange of old phone - then pre tax value will be 20,000 and taxable value will be 24,000, assuming exchange value of old phone is 4,000. Another example is in the case of real estate where pre-tax value may be different from taxable value). |
| ordLineRef                                   | String | Order line reference                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| orgCntry                                     | String | This is to specify item origin country like mobile phone sold in India could be manufactured in other country.                                                                                                                                                                                                                                                                                                                                                                                                                                |
| prdSlNo                                      | String | Serial number in case of each item having a unique number.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| attNm                                        | String | Attribute details of the item.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| attVal                                       | String | Attribute value of item.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| itmgen1                                      | String | Cess Non-Advalorem Rate as required for EWB generation purposes. Allowed values as per Master Codes only. Eg for a product if cess non ad val is 400 per 100, then here value to be inputted in 400. If for some other product it is 4170 per 1000 then value to be inputted is 4170                                                                                                                                                                                                                                                          |
| invRmk                                       | String | Any specific remarks with respect to invoice can be entered here                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| invStDt                                      | String | Start Date of invoice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| invEndDt                                     | String | End Date of invoice                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| oinum                                        | String | If user wants to provide in a document, a reference to any preceding invoice or debit note or credit note, then this represents the number of such preceding document. Details can be provided in case of amendments                                                                                                                                                                                                                                                                                                                          |

{% tabs %}
{% tab title="200 " %}

```
{
  "status": "SUCCESS",
  "message": "operation performed successfully",
  "response": {
    "qrCode": "iVBORw0KGgoAAAANSUhEUgAAAPoAAAD6AQAAAACgl2eQAAAHfklEQVR42u2ZzYpdOw6FBZoK9CoGTQ1+dYOnBr2KQFODejmQqknT2z1penALAknly8nZlrV+TlH9569J/wD/AP9zIKgdV21kRqm7x5TNk2QQPwJZdqxZp+rmZEVSIt54jHwFuI1GPaibjjZq7p4iIdrsGbA5W3KObhQ7zYelSuZ/AXSOPunw8EkzTgs+Zr7egWqdJKMdoQwOGSvIhfz3HD6AwBn/26/fWXwAVacvvE/tti38tMp0Txm/9+EDiOjFHKxSGrRzZ+M2a6/Nr8Cc1hpr20S8zFaRUt++x3gEanKSci45zmv1Gn0V7xrxCkTf6bPxDt4dL902HrObtPRXwNhkp7bCm7Tk7V5u2ZvxI5Ajcx3ua9tYk+Iok1Yna/oKOLWm4kXlA0PCbc3sXpKvQJ37a7Q9SGeT07bGHrH3ykcgZpdkWYOarD7LT80xVGmsV4Bi4JglMPS1G23D8pym/nMfvoCTBAXBiHV5qxJISC2bxX8P6hOofSBb1LyfPdauKRi9mGjWI5AbM17VaFruNQ/2fqXtye6PwOlpQwmXhqFAwl25t2WunR+BaozvCx6wihIPWx2X3xdk9REIm9CsvaDevsN7c/zpUKnnI1DEXD6Zl3pAEhnfwJUNIn8ETgbEh3FI2NpYtpJjmOP4xiMQuObB1iZmbVY7C+qOLTB7BlbARlaOMSElG54CZ8AI82f9v4DTiAhbay1wZUPp2oG31UgfAbwSVA+WuqO3kNlxTjBG0fJXQEgNV2RBtTBoqVSMDJK4X4HQyZI0ZTSNeXVgYvQsZK9AOW3p5Qoba+JbsPsMfXetZyAi+5jQU45cLWBn/QRgfgROs7C1p2PXRI0Twu7dHdf2EQi60km1ETCwQt36hAiYYJcfgeuJss5ISIjBUXWH5sQ/+3vlPoGYuC2am05DuCmCPa5UHN6PNX8BiWBBLQdm7WdWu3tUUCHq4xXQs/sQOoXDXTTCI7diVn/H/QkgHsmeR1NHZ4Elt4CA5bBhj0DUVX+bPHNKIi36Ysf8ScYjgN1PN+cSSMiEDuMZXaDGP4vzBcDDmuGA98D6FHKmdt/VFGr2CBRWZGXiqh9kTmVFVEw1wUm9Aow5H6SqoQfvdyM8qkKM4c2PAKy5xjhYeTd4opwS3P91qOsjgEQlh/CAO3YsMXae+zSfqx6BgB3waozrJniTQ3rD/d1YQHsFIMVxVoadyRG+kbaQ/hxDfAQON/QGWACUkLE7uUB02Mrvpf0AkJKX04ryawRaAXtyjDsjHwHYQXUlhNTZgkSgQexENslfgYmEgNO+GWvfOz8ROelAkOoRQGzeJrJRwlx5DdgbGgA2IccjEEjpyP+InHNPeMpRvL0DPfwJe1/AuS1sIReUIuxAiF2bFCPAvgLRseuRhOOKWbXmDGVBIxmvwMF9Zxp+s2LPxFH1SoII/ES1L6B0m+OpfKOKwghCkRiPbR31CrTeNZceW2MwRmVXPZri6xFA+RI5yImGJoxCrVhFXB5lW49AtnHPlrCtG730uhNkuTB3fwRCEPZjOuIBDsh7oHtggUXPKwBHmZAeQw8OmMtqtaClm0Z/BhQmAm+1gfy+m1d2CTSC9XOSX0AKmtc5C7EZ4d8Rk/rA+of+leJPIE6cJojKI32F3I8pWKCr80eKPwGBlWn2a9FLW1ojRK6p+xk4fHqnree435iFVuttnrm6PwI4WfLczpDBHjUOBl2CEvFzkl8AHhM2PANHhohxC/VA2Ej/3c0v4BAymqIsEBc6IbRoEly6NeZHACaC1oa4Ng4kfO7ihD+gYEY9Arj3cAL4z58W4R0loi30Kfu1gw8gkKkUjrQGDB4HBXdNwe9RZx6BM+nWSKye0eTWEcQJbRIPm49AIGjGqIG4hhe+jbJQrbtor0fg4M/INZZ4yZ63AzJKxMJ3n4FxkGkUGti0AW3IBvg9gnc+AnEGxjJykKk1ZAMkRcSTDNJXYAdqHNpgawoVYt9XylXWzkfgEOk+affjJk144sDeo0bJ0VfgCmZB+4234Lri5BuURJjqEUCBwk13rIliXxBXYSdYHUzgFUjUwBXoUQJv3RDTPfgK6Z8m9gQcOAgbDBEGciPWWmYJi3wHYk2UHybFlC0w7pOY+i2V/giUjNU7sm4b90MjhoS2NjcCyisQZyKUoUoOJBxp50xDj8t9/tbJTwBn2ife2bSFvypBWMol93n9EcChnH6m3o/fFvLZvE+KBz+/1vwBoAQLShxGnveYeC9ae6v8hL1v4MoH4j+3+8npQBlKONL92ClfARyQKeXqyCl2BVAtMHSIwiNQmDL6XHcUyTX2hhh2Pfh/fz6f/ARuVJwN0udxfz7QBR0ADQAF/xWAIUTClCfGheRPji7FCJA/H6J+AXhZ0on6gFqMcOWwM9sEm/yxgy/gz49I5A4Kd+TGA2gqZg0tWa8A20AgQGVABcFL2/lTphbReAbQXLDzc2ihfqFD4NxHp/xrrA9AD7ofPOLvaKJbIqzVWAgJ4xWAkeLqQ8YIZRRJ834CBSX8/YjjCwjYQJ7pfV0J2zH6xOagBBx7BP75yeA/wP8V8C/LfRb3Y34pFQAAAABJRU5ErkJggg==",
    "no": "1809961",
    "id": 51587,
    "genBy": "amit.nandha@irisbusiness.com",
    "genByName": "Amit Nandha",
    "status": "ACT",
    "ackNo": 112010005963729,
    "ackDt": "2020-09-19 00:23:00",
    "irn": "0c3e498d5cb6380ceb2c8fe7a0d27702662bc9742d2d0aa6c11e3daead23362f",
    "signedInvoice": "eyJhbGciOiJSUzI1NiIsImtpZCI6IkVEQzU3REUxMzU4QjMwMEJBOUY3OTM0MEE2Njk2ODMxRjNDODUwNDciLCJ0eXAiOiJKV1QiLCJ4NXQiOiI3Y1Y5NFRXTE1BdXA5NU5BcG1sb01mUElVRWMifQ.eyJkYXRhIjoie1wiQWNrTm9cIjoxMTIwMTAwMDU5NjM3MjksXCJBY2tEdFwiOlwiMjAyMC0wOS0xOSAwMDoyMzowMFwiLFwiSXJuXCI6XCIwYzNlNDk4ZDVjYjYzODBjZWIyYzhmZTdhMGQyNzcwMjY2MmJjOTc0MmQyZDBhYTZjMTFlM2RhZWFkMjMzNjJmXCIsXCJWZXJzaW9uXCI6XCIxLjAxXCIsXCJUcmFuRHRsc1wiOntcIlRheFNjaFwiOlwiR1NUXCIsXCJTdXBUeXBcIjpcIkIyQlwiLFwiUmVnUmV2XCI6XCJOXCIsXCJJZ3N0T25JbnRyYVwiOlwiTlwifSxcIkRvY0R0bHNcIjp7XCJUeXBcIjpcIklOVlwiLFwiTm9cIjpcIjE4MDk5NjFcIixcIkR0XCI6XCIyOC8wOC8yMDIwXCJ9LFwiU2VsbGVyRHRsc1wiOntcIkdzdGluXCI6XCIyOUFBQUNJOTI2MFIwMDBcIixcIkxnbE5tXCI6XCJOQUhBUlNQR01JTExTTFREKFBMT1QtMzczKVwiLFwiVHJkTm1cIjpcIk5BSEFSU1BHTUlMTFNMVEQoUExPVC0zNzMpXCIsXCJBZGRyMVwiOlwiKFBST1AuTkFIQVJTUEdNSUxMU0xURC4pXCIsXCJBZGRyMlwiOlwiSEVBRE9GRklDRVwiLFwiTG9jXCI6XCJMVURISUFOQVwiLFwiUGluXCI6NTg3MjAxLFwiU3RjZFwiOlwiMjlcIn0sXCJCdXllckR0bHNcIjp7XCJHc3RpblwiOlwiMjNBQUFDTjU3MTBEMVo0XCIsXCJMZ2xObVwiOlwiTkFIQVJTUEdNSUxMU0xURC5VTklULUVYVFwiLFwiVHJkTm1cIjpcIk5BSEFSU1BHTUlMTFNMVEQuVU5JVC1FWFRcIixcIlBvc1wiOlwiMjdcIixcIkFkZHIxXCI6XCJWSUxMU0lNUkFJLE1BTkRJREVFUCxcIixcIkxvY1wiOlwiTUFORElERUVQXCIsXCJQaW5cIjo0NTc4ODcsXCJQaFwiOlwiMDc0ODAyMzMwOTFcIixcIlN0Y2RcIjpcIjIzXCJ9LFwiSXRlbUxpc3RcIjpbe1wiSXRlbU5vXCI6MCxcIlNsTm9cIjpcIjEwXCIsXCJJc1NlcnZjXCI6XCJOXCIsXCJIc25DZFwiOlwiNjMxMFwiLFwiUXR5XCI6MS4wMCxcIkZyZWVRdHlcIjowLjAwMCxcIlVuaXRcIjpcIk5PU1wiLFwiVW5pdFByaWNlXCI6MjUwMDAwLjAwLFwiVG90QW10XCI6MjUwMDAwLjAwLFwiRGlzY291bnRcIjowLjAwLFwiUHJlVGF4VmFsXCI6MC4wMCxcIkFzc0FtdFwiOjI1MDAwMC4wMCxcIkdzdFJ0XCI6MC4wMCxcIklnc3RBbXRcIjowLjAwLFwiQ2dzdEFtdFwiOjAuMDAsXCJTZ3N0QW10XCI6MC4wMCxcIkNlc1J0XCI6MC4wMCxcIkNlc0FtdFwiOjAuMDAsXCJDZXNOb25BZHZsQW10XCI6MC4wMCxcIlN0YXRlQ2VzUnRcIjowLjAwLFwiU3RhdGVDZXNBbXRcIjowLjAwLFwiT3RoQ2hyZ1wiOjAuMDAsXCJUb3RJdGVtVmFsXCI6MjUwMDAwLjAwLFwiQXR0cmliRHRsc1wiOlt7XCJObVwiOlwiMDAwMDEwXCIsXCJWYWxcIjpcIjAuMDBcIn1dfV0sXCJWYWxEdGxzXCI6e1wiQXNzVmFsXCI6MjUwMDAwLjAwLFwiQ2dzdFZhbFwiOjAuMDAsXCJJZ3N0VmFsXCI6MC4wMCxcIkNlc1ZhbFwiOjAuMDAsXCJTdENlc1ZhbFwiOjAuMDAsXCJEaXNjb3VudFwiOjAuMDAsXCJPdGhDaHJnXCI6MC4wMCxcIlJuZE9mZkFtdFwiOjAuMDAsXCJUb3RJbnZWYWxcIjoyNTAwMDAuMDAsXCJUb3RJbnZWYWxGY1wiOjAuMDB9LFwiUGF5RHRsc1wiOntcIkNyRGF5XCI6MCxcIlBhaWRBbXRcIjowLjAwLFwiUGF5bXREdWVcIjowLjAwfSxcIlJlZkR0bHNcIjp7fSxcIkV3YkR0bHNcIjp7XCJUcmFuc0lkXCI6XCIyOUFBQUNJOTI2MFIwMDBcIixcIlRyYW5zTmFtZVwiOlwiQUJDXCIsXCJUcmFuc01vZGVcIjpcIjFcIixcIkRpc3RhbmNlXCI6OTU2LFwiVHJhbnNEb2NOb1wiOlwiMTAyOVwiLFwiVHJhbnNEb2NEdFwiOlwiMjgvMDgvMjAyMFwiLFwiVmVoTm9cIjpcIk1IMDFZVTEyMzRcIixcIlZlaFR5cGVcIjpcIlJcIn19IiwiaXNzIjoiTklDIn0.HilzZ9FaMBOdyQ1mmDiNrZcb7-Zm3vYUaJyHBzMVw258S1QuG11W4aA48q9KV_Ck-0DEmGsJlj37K2klLRfSu5TVZL1RtclkiLvGCIDFVH-AR8VX5pvuGi6gUfPvfcUNn2b9WA7Qiafe63sn2FIQzSTLBXU9hETuN54hlckwOJ0rnkdYLee5m7BjwaGgeEcQnCM4I2CHJuDBy2wj73iERXRTbp_w0vADQCz48huOYNtkULXeL3FbIa3EbNp8fZgKqEV8tmje1oqAvmTRxm89h2OOEALEoBwLxisuydLY_-W3i0osQvmXB57fTfc5o8OGOSa8V-c9JdkwUbnwlKznAw",
    "signedQrCode": "eyJhbGciOiJSUzI1NiIsImtpZCI6IkVEQzU3REUxMzU4QjMwMEJBOUY3OTM0MEE2Njk2ODMxRjNDODUwNDciLCJ0eXAiOiJKV1QiLCJ4NXQiOiI3Y1Y5NFRXTE1BdXA5NU5BcG1sb01mUElVRWMifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFBQ0k5MjYwUjAwMFwiLFwiQnV5ZXJHc3RpblwiOlwiMjNBQUFDTjU3MTBEMVo0XCIsXCJEb2NOb1wiOlwiMTgwOTk2MVwiLFwiRG9jVHlwXCI6XCJJTlZcIixcIkRvY0R0XCI6XCIyOC8wOC8yMDIwXCIsXCJUb3RJbnZWYWxcIjoyNTAwMDAuMDAsXCJJdGVtQ250XCI6MSxcIk1haW5Ic25Db2RlXCI6XCI2MzEwXCIsXCJJcm5cIjpcIjBjM2U0OThkNWNiNjM4MGNlYjJjOGZlN2EwZDI3NzAyNjYyYmM5NzQyZDJkMGFhNmMxMWUzZGFlYWQyMzM2MmZcIixcIklybkR0XCI6XCIyMDIwLTA5LTE5IDAwOjIzOjAwXCJ9IiwiaXNzIjoiTklDIn0.szP6ZIees02yz4j4-AIiuTjdiJTYRZPqz9QK4lcZPvx5yY6awP5DG3wn7DuLFA4VMU4KJ4rNN2tv1lSkKM9EHYgCqivj7qCNt9J5KGZAwjSc4RH8MWbUrz3KLvRC_dc5EVGlYqeAsQFdW9DWqf_w8o7PsitwJ8yPaz-KUo07Qr95djEubynB7u7e3crw6t706aPrmRqmCNF-Hne5ZYfe0yQK7xjkWMob9j-G9geCeLUoNwNygFGPnoFvMIm1tk5OAfxTnXSZR1mW14kd8v1eArWlFViZHWmCcngCsnBken5cIUQWW_pPxK3H5_YD2ZzTHn9G9zNaPTslKnhJoG0KWA",
    "EwbNo": "191008719181",
    "EwbDt": "2020-09-19 00:24:00",
    "EwbValidTill": "2020-09-29 23:59:00"
  }
}

```

{% endtab %}
{% endtabs %}

#### Sample code

{% tabs %}
{% tab title="CURL" %}

```javascript
curl --location --request POST '<BASE URL>/api/v1/einvoice/save' \
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userGstin": "01AAACI9260R002",
    "pobCode": null,
    "supplyType": "O",
    "ntr": "Inter",
    "docType": "RI",
    "catg": "B2B",
    "dst": "O",
    "trnTyp": "REG",
    "no": "AG/03-09/4565",
    "dt": "28-03-2021",
    "refinum": null,
    "refidt": null,
    "pos": "27",
    "diffprcnt": null,
    "etin": null,
    "rchrg": "N",
    "sgstin": "01AAACI9260R002",
    "strdNm": "TEST Company",
    "slglNm": "TEST PROD",
    "sbnm": "Testing",
    "sflno": "ABC",
    "sloc": "BANGALOR32",
    "sdst": "BENGALURU",
    "sstcd": "01",
    "spin": "192233",
    "sph": "123456111111",
    "sem": "abc123@gmail.com",
    "bgstin": "02AAACI9260R002",
    "btrdNm": "TEST ENTERPRISES",
    "blglNm": "TEST PRODUCT",
    "bbnm": "ABCD12345",
    "bflno": "abc",
    "bloc": "Jijamat",
    "bdst": "BANGALORE",
    "bstcd": "02",
    "bpin": "174001",
    "bph": "989898111111",
    "bem": "abc123@gmail.com",
    "dgstin": null,
    "dtrdNm": null,
    "dlglNm": null,
    "dbnm": null,
    "dflno": null,
    "dloc": null,
    "ddst": null,
    "dstcd": null,
    "dpin": null,
    "dph": null,
    "dem": null,
    "togstin": null,
    "totrdNm": null,
    "tolglNm": null,
    "tobnm": null,
    "toflno": null,
    "toloc": null,
    "todst": null,
    "tostcd": null,
    "topin": null,
    "toph": null,
    "toem": null,
    "sbnum": null,
    "sbdt": null,
    "port": null,
    "expduty": 1234,
    "cntcd": null,
    "forCur": null,
    "invForCur": null,
    "taxSch": "GST",
    "totinvval": 4262.73,
    "totdisc": 10,
    "totfrt": null,
    "totins": null,
    "totpkg": null,
    "totothchrg": 20,
    "tottxval": 3322.45,
    "totiamt": 930.28,
    "totcamt": 0,
    "totsamt": 0,
    "totcsamt": 0,
    "totstcsamt": 0,
    "rndOffAmt": 0,
    "sec7act": "N",
    "invStDt": null,
    "invEndDt": null,
    "invRmk": null,
    "omon": null,
    "odty": null,
    "oinvtyp": "B2CL",
    "octin": null,
    "userIRN": null,
    "payNm": null,
    "acctdet": null,
    "pa":null,
    "mode": null,
    "ifsc": null,
    "payTerm": null,
    "payInstr": null,
    "crTrn": null,
    "dirDr": null,
    "crDay": null,
    "balAmt": null,
    "paidAmt": null,
    "payDueDt": null,
    "transId": null,
    "subSplyTyp": "Supply",
    "subSplyDes": null,
    "kdrefinum": null,
    "kdrefidt": null,
    "transMode": null,
    "vehTyp": null,
    "transDist": "",
    "transName": null,
    "transDocNo": null,
    "transDocDate": null,
    "vehNo": null,
    "clmrfnd": null,
    "rfndelg": null,
    "boef": null,
    "fy": null,
    "refnum": null,
    "pdt": null,
    "ivst": null,
    "cptycde": null,
    "gen1": "abcd",
    "gen2": "abcd",
    "gen3": "abcd",
    "gen4": "abcd",
    "gen5": "abcd",
    "gen6": "abcd",
    "gen7": "abcd",
    "gen8": "abcd",
    "gen9": "abcd",
    "gen10": "abcd",
    "gen11": "abcd",
    "gen12": "abcd",
    "gen13": "abcd",
    "gen14": "PJTCG001",
    "gen15": "abcd",
    "gen16": "abcd",
    "gen17": "abcd",
    "gen18": "abcd",
    "gen19": "abcd",
    "gen20": "abcd",
    "gen21": "abcd",
    "gen22": "abcd",
    "gen23": "abcd",
    "gen24": "abcd",
    "gen25": "abcd",
    "gen26": "abcd",
    "gen27": "abcd",
    "gen28": "abcd",
    "gen29": "abcd",
    "gen30": "abcd",
    "pobewb": "Null",
    "pobret": "Null",
    "tcsrt": "null",
    "tcsamt": 0,
    "pretcs": 0,
    "genIrn": true,
    "genewb": "N",
    "signedDataReq": true,
    "itemList": [
      {
        "barcde": null,
        "bchExpDt": null,
        "bchWrDt": null,
        "bchnm": null,
        "camt": 0,
        "cesNonAdval": 0,
        "stCesNonAdvl": 0,
        "crt": 0,
        "csamt": 0,
        "csrt": 0,
        "disc": 0,
        "freeQty": 0,
        "hsnCd": "73041190",
        "iamt": 930.28,
        "irt": 28,
        "isServc": null,
        "itmgen1": null,
        "itmgen2": null,
        "itmgen3": null,
        "itmgen4": null,
        "itmgen5": null,
        "itmgen6": null,
        "itmgen7": null,
        "itmgen8": null,
        "itmgen9": null,
        "itmgen10": null,
        "itmVal": 4252.73,
        "num": "00001",
        "ordLineRef": null,
        "orgCntry": null,
        "othchrg": 0,
        "prdDesc": null,
        "prdNm": "SEAMLESS STEEL TUBE 10X2 -U71889903",
        "prdSlNo": null,
        "preTaxVal": 0,
        "qty": 1,
        "rt": 28,
        "samt": 0,
        "srt": 0,
        "stcsamt": 0,
        "stcsrt": 0,
        "sval": 3322.45,
        "txp": null,
        "txval": 3322.45,
        "unit": "NOS",
        "unitPrice": 3322.451,
        "invItmOtherDtls": [
          {
            "attNm": "aaa",
            "attVal": "aaa"
          },
          {
            "attNm": "xyz",
            "attVal": "2300"
          }
        ]
      }
    ],
    "invOthDocDtls": [
      {
        "url": "www.google.com",
        "docs": "This is the url",
        "infoDtls": "abcd"
      }
    ],
    "invRefPreDtls": [
      {
        "oinum": null,
        "oidt": null,
        "othRefNo": null
      }
    ],
    "invRefContDtls": [
      {
        "raref": null,
        "radt": null,
        "tendref": null,
        "contref": null,
        "extref": null,
        "projref": null,
        "poref": null,
        "porefdt": null
      }
    ]
  }'
```

{% endtab %}

{% tab title="PHP" %}

```

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '<BASE URL>/api/v1/einvoice/save',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "userGstin": "01AAACI9260R002",
    "pobCode": null,
    "supplyType": "O",
    "ntr": "Inter",
    "docType": "RI",
    "catg": "B2B",
    "dst": "O",
    "trnTyp": "REG",
    "no": "AG/03-09/4565",
    "dt": "28-03-2021",
    "refinum": null,
    "refidt": null,
    "pos": "27",
    "diffprcnt": null,
    "etin": null,
    "rchrg": "N",
    "sgstin": "01AAACI9260R002",
    "strdNm": "TEST Company",
    "slglNm": "TEST PROD",
    "sbnm": "Testing",
    "sflno": "ABC",
    "sloc": "BANGALOR32",
    "sdst": "BENGALURU",
    "sstcd": "01",
    "spin": "192233",
    "sph": "123456111111",
    "sem": "abc123@gmail.com",
    "bgstin": "02AAACI9260R002",
    "btrdNm": "TEST ENTERPRISES",
    "blglNm": "TEST PRODUCT",
    "bbnm": "ABCD12345",
    "bflno": "abc",
    "bloc": "Jijamat",
    "bdst": "BANGALORE",
    "bstcd": "02",
    "bpin": "174001",
    "bph": "989898111111",
    "bem": "abc123@gmail.com",
    "dgstin": null,
    "dtrdNm": null,
    "dlglNm": null,
    "dbnm": null,
    "dflno": null,
    "dloc": null,
    "ddst": null,
    "dstcd": null,
    "dpin": null,
    "dph": null,
    "dem": null,
    "togstin": null,
    "totrdNm": null,
    "tolglNm": null,
    "tobnm": null,
    "toflno": null,
    "toloc": null,
    "todst": null,
    "tostcd": null,
    "topin": null,
    "toph": null,
    "toem": null,
    "sbnum": null,
    "sbdt": null,
    "port": null,
    "expduty": 1234,
    "cntcd": null,
    "forCur": null,
    "invForCur": null,
    "taxSch": "GST",
    "totinvval": 4262.73,
    "totdisc": 10,
    "totfrt": null,
    "totins": null,
    "totpkg": null,
    "totothchrg": 20,
    "tottxval": 3322.45,
    "totiamt": 930.28,
    "totcamt": 0,
    "totsamt": 0,
    "totcsamt": 0,
    "totstcsamt": 0,
    "rndOffAmt": 0,
    "sec7act": "N",
    "invStDt": null,
    "invEndDt": null,
    "invRmk": null,
    "omon": null,
    "odty": null,
    "oinvtyp": "B2CL",
    "octin": null,
    "userIRN": null,
    "payNm": null,
    "acctdet": null,
    "pa":null,
    "mode": null,
    "ifsc": null,
    "payTerm": null,
    "payInstr": null,
    "crTrn": null,
    "dirDr": null,
    "crDay": null,
    "balAmt": null,
    "paidAmt": null,
    "payDueDt": null,
    "transId": null,
    "subSplyTyp": "Supply",
    "subSplyDes": null,
    "kdrefinum": null,
    "kdrefidt": null,
    "transMode": null,
    "vehTyp": null,
    "transDist": "",
    "transName": null,
    "transDocNo": null,
    "transDocDate": null,
    "vehNo": null,
    "clmrfnd": null,
    "rfndelg": null,
    "boef": null,
    "fy": null,
    "refnum": null,
    "pdt": null,
    "ivst": null,
    "cptycde": null,
    "gen1": "abcd",
    "gen2": "abcd",
    "gen3": "abcd",
    "gen4": "abcd",
    "gen5": "abcd",
    "gen6": "abcd",
    "gen7": "abcd",
    "gen8": "abcd",
    "gen9": "abcd",
    "gen10": "abcd",
    "gen11": "abcd",
    "gen12": "abcd",
    "gen13": "abcd",
    "gen14": "PJTCG001",
    "gen15": "abcd",
    "gen16": "abcd",
    "gen17": "abcd",
    "gen18": "abcd",
    "gen19": "abcd",
    "gen20": "abcd",
    "gen21": "abcd",
    "gen22": "abcd",
    "gen23": "abcd",
    "gen24": "abcd",
    "gen25": "abcd",
    "gen26": "abcd",
    "gen27": "abcd",
    "gen28": "abcd",
    "gen29": "abcd",
    "gen30": "abcd",
    "pobewb": "Null",
    "pobret": "Null",
    "tcsrt": "null",
    "tcsamt": 0,
    "pretcs": 0,
    "genIrn": true,
    "genewb": "N",
    "signedDataReq": true,
    "itemList": [
      {
        "barcde": null,
        "bchExpDt": null,
        "bchWrDt": null,
        "bchnm": null,
        "camt": 0,
        "cesNonAdval": 0,
        "stCesNonAdvl": 0,
        "crt": 0,
        "csamt": 0,
        "csrt": 0,
        "disc": 0,
        "freeQty": 0,
        "hsnCd": "73041190",
        "iamt": 930.28,
        "irt": 28,
        "isServc": null,
        "itmgen1": null,
        "itmgen2": null,
        "itmgen3": null,
        "itmgen4": null,
        "itmgen5": null,
        "itmgen6": null,
        "itmgen7": null,
        "itmgen8": null,
        "itmgen9": null,
        "itmgen10": null,
        "itmVal": 4252.73,
        "num": "00001",
        "ordLineRef": null,
        "orgCntry": null,
        "othchrg": 0,
        "prdDesc": null,
        "prdNm": "SEAMLESS STEEL TUBE 10X2 -U71889903",
        "prdSlNo": null,
        "preTaxVal": 0,
        "qty": 1,
        "rt": 28,
        "samt": 0,
        "srt": 0,
        "stcsamt": 0,
        "stcsrt": 0,
        "sval": 3322.45,
        "txp": null,
        "txval": 3322.45,
        "unit": "NOS",
        "unitPrice": 3322.451,
        "invItmOtherDtls": [
          {
            "attNm": "aaa",
            "attVal": "aaa"
          },
          {
            "attNm": "xyz",
            "attVal": "2300"
          }
        ]
      }
    ],
    "invOthDocDtls": [
      {
        "url": "www.google.com",
        "docs": "This is the url",
        "infoDtls": "abcd"
      }
    ],
    "invRefPreDtls": [
      {
        "oinum": null,
        "oidt": null,
        "othRefNo": null
      }
    ],
    "invRefContDtls": [
      {
        "raref": null,
        "radt": null,
        "tendref": null,
        "contref": null,
        "extref": null,
        "projref": null,
        "poref": null,
        "porefdt": null
      }
    ]
  }',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer <TOKEN>',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
```

{% endtab %}
{% endtabs %}

## E-invoice cancel

<mark style="color:green;">`POST`</mark> `/api/v1/einvoice/cancel`

This endpoint allows you to cancel invoice.

#### Headers

| Name          | Type   | Description       |
| ------------- | ------ | ----------------- |
| Authorization | string | Bearer auth token |
| Content-Type  | string | application/json  |

{% tabs %}
{% tab title="200 " %}

```
{"status":"SUCCESS","message":"operation performed successfully","response":{"irn":"a287f526ec393d69a6202156d285e2e508902dedda1ed3daeadda8a5c2696a6d","cancelDate":"2020-02-06 19:30:00"},"fieldErrors":null,"errors":null}

```

{% endtab %}
{% endtabs %}

#### Sample code

{% tabs %}
{% tab title="CURL" %}

```javascript
curl --location --request POST '<BASE URL>/api/v1/einvoice/cancel' \
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
	"irn":"a287f526ec393d69a6202156d285e2e508902dedda1ed3daeadda8a5c2696a6d",
	"cnlRsn":"1",
	"cnlRem":"Wrong entry",
	"userGstin":"01AAACI9260R002"
}'
```

{% endtab %}

{% tab title="PHP" %}

```

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '<BASE URL>/api/v1/einvoice/cancel',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
	"irn":"a287f526ec393d69a6202156d285e2e508902dedda1ed3daeadda8a5c2696a6d",
	"cnlRsn":"1",
	"cnlRem":"Wrong entry",
	"userGstin":"01AAACI9260R002"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer <TOKEN>',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
```

{% endtab %}
{% endtabs %}

## E-invoice list

<mark style="color:green;">`POST`</mark> `/api/v1/einvoice/list`

This endpoint allows you to get invoice list.

#### Headers

| Name          | Type   | Description       |
| ------------- | ------ | ----------------- |
| Authorization | string | Bearer auth token |
| Content-Type  | string | application/json  |

{% tabs %}
{% tab title="200 " %}

```
{
  "status": "SUCCESS",
  "message": "Einvoices filtered successfully",
  "response": {
    "data": [
      {
        "einvId": 371,
        "docType": "RI",
        "catg": "B2B",
        "docNo": "P001",
        "docDt": "01/01/2020",
        "bgstin": "33GSPTN0121G1ZP",
        "btrdNm": "Big basket Ltd",
        "invStatus": "UPLOADED",
        "totinvval": 22356,
        "numItems": 0,
        "hasError": true,
        "hasWarning": true
      }
    ],
    "pageNumber": 0,
    "numberOfElements": 1,
    "totalElements": 1,
    "totalPages": 1
  },
  "fieldErrors": null,
  "errors": null
}
```

{% endtab %}
{% endtabs %}

#### Sample code

{% tabs %}
{% tab title="CURL" %}

```javascript
curl --location --request POST '<BASE URL>/api/v1/einvoice/list' \
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gstin": "01AAACI9260R002",
    "docNo": [
        "12369"
    ],
    "fromDt": "19/02/2020",
    "toDt": "19/02/2020",
    "btrdNm": "Aamir Traders",
    "catg": [
        "B2B"
    ],
    "docType": [
        "RI"
    ],
    "invStatus": [
        "UPLOADED",
        "IRN_GENERATED"
    ],
    "irnStatus": [
        "ACT",
        "CAN"
    ],
    "totinvval": {
        "gt": "8000"
    },
    "itemCount": {
        "gt": "0"
    },
    "hasError": false,
    "hasWarning": true,
    "page": 0,
    "size": 50
}'
```

{% endtab %}

{% tab title="PHP" %}

```

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '<BASE URL>/api/v1/einvoice/list',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "gstin": "01AAACI9260R002",
    "docNo": [
        "12369"
    ],
    "fromDt": "19/02/2020",
    "toDt": "19/02/2020",
    "btrdNm": "Aamir Traders",
    "catg": [
        "B2B"
    ],
    "docType": [
        "RI"
    ],
    "invStatus": [
        "UPLOADED",
        "IRN_GENERATED"
    ],
    "irnStatus": [
        "ACT",
        "CAN"
    ],
    "totinvval": {
        "gt": "8000"
    },
    "itemCount": {
        "gt": "0"
    },
    "hasError": false,
    "hasWarning": true,
    "page": 0,
    "size": 50
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer <TOKEN>',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
```

{% endtab %}
{% endtabs %}

## Get invoice details

<mark style="color:blue;">`GET`</mark> `/api/v1/einvoice/details`

This endpoint allows you to get the invoice details.

#### Query Parameters

| Name                                     | Type   | Description |
| ---------------------------------------- | ------ | ----------- |
| einvId<mark style="color:red;">\*</mark> | String |             |

#### Headers

| Name          | Type   | Description       |
| ------------- | ------ | ----------------- |
| Authorization | string | Bearer auth token |
| Content-Type  | string | application/json  |

#### Request Body

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | String |             |

{% tabs %}
{% tab title="200 " %}

```
{
    "status": "SUCCESS",
    "message": "Einvoice ftched successfully",
    "response": {
      "einvId": 332,
      "supplyType": "O",
      "docType": "RI",
      "catg": "B2B",
      "docNo": "123652",
      "docDt": "12/05/2019",
      "trnTyp": "REG",
      "bgstin": "28AAACG0569P1Z3",
      "btrdNm": "LAKSHMI ENTERPRISES",
      "itemList": [
        {
          "prdNm": "WHEAT AND MESLIN",
          "prdDesc": "WHEAT AND MESLIN",
          "hsnCd": "1001",
          "qty": 2,
          "unit": "BAG",
          "unitPrice": 100,
          "sval": 200,
          "txval": 205,
          "rt": 18,
          "iamt": 0,
          "camt": 0,
          "samt": 0,
          "csamt": 1,
          "stcsamt": 2,
          "errors": [
            {
              "errorId": 1920,
              "fieldName": "txval",
              "type": "ERROR",
              "description": "If docTyp = RI/BS then Assessable amount/ Taxable amount should be item Total Amount - Discount + Other charges.",
              "lineItemIdFk": 1196
            },
            {
              "errorId": 1921,
              "fieldName": "rt",
              "type": "ERROR",
              "description": "Tax rates and amounts should not be present for Nil exempt and Non-gst supplies.",
              "lineItemIdFk": 1196
            },
            {
              "errorId": 1922,
              "fieldName": "crt",
              "type": "ERROR",
              "description": "CGST rate should not be filled for inter-state transactions.",
              "lineItemIdFk": 1196
            },
            {
              "errorId": 1923,
              "fieldName": "srt",
              "type": "ERROR",
              "description": "SGST rate should not be filled for inter-state transactions.",
              "lineItemIdFk": 1196
            }
          ],
          "hasError": false,
          "hasWarning": false
        }
      ],
      "irnStatus": "ACT",
      "totinvval": 12400,
      "hasError": false,
      "hasWarning": false,
      "ntr": "INTER",
      "dst": "O",
      "rchrg": "Y",
      "pos": 4,
      "etin": "37BZNPM9430M1KL",
      "sgstin": "29ACQPN4602B000",
      "strdNm": "AMBIKA CEMENTS",
      "sbno": "1",
      "sbnm": "AMBIKA CEMENTS",
      "sflno": "2",
      "sloc": "BENGALURU",
      "sdst": "BENGALURU",
      "sstcd": 29,
      "spin": 560090,
      "sph": 9898989898,
      "sem": "abc123@gmail.com",
      "bbno": "785",
      "bbnm": "test",
      "bflno": "ab",
      "bloc": "BANGALORE",
      "bdst": "BANGALORE",
      "bstcd": 29,
      "bpin": 560054,
      "bph": 9898989898,
      "bem": "abc123@gmail.com",
      "dstcd": 0,
      "dpin": 0,
      "dph": 9898989898,
      "tostcd": 0,
      "topin": 0,
      "toph": 0,
      "cntcd": "IN",
      "taxSch": "GST",
      "tottxval": 10000,
      "totiamt": 0,
      "totcamt": 1200,
      "totsamt": 1200,
      "totstcsamt": 0,
      "totcsNonAdVal": 0,
      "sec7act": "Y",
      "crDay": 0,
      "ackNo": 10100041122,
      "ackDt": "2020-02-05T11:56:00.000+0000",
      "irn": "fa1a2a58b37173b241f2bea41f97621e125fbd9cd982eed64fc3ae2b4abe95a5"
    },
    "fieldErrors": null,
    "errors": null
  }
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="CURL" %}

```javascript
curl --location --request GET '<BASE URL>/api/v1/einvoice/details?einvId=2133' \
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json' \
```

{% endtab %}

{% tab title="PHP" %}

```

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '<BASE URL>/api/v1/einvoice/details?einvId=2133',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  ,
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer <TOKEN>',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
```

{% endtab %}
{% endtabs %}

#### Sample code


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.swipez.in/e-invoicing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
