Create a document

Customer id and Product id should be unique, if a new id is sent, a new Customer/Product with given details will be automatically created. For Product If an existing id is sent, the details will not override the original product details. They will be applicable only to the current document. For updating the product details, use the update product API

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

document_date

string

required

DD-MM-YYYY, Invoice date (Ex: 11-06-2024 Need not to the current date)

document_type

enum<string>

required

Value should always be the string 'invoice'

Available options:

invoice,

subscription,

pro_forma_invoice,

estimate,

sales_return,

purchase_return

items

object[]

required

Array of Products/Services, refer Item Object below for parameters

bank_details

object

Bank Details, refer Bank Details Object below for parameters, If account_number, ifsc matched with existing bank details, it will be used, else new bank details will be added to your swipe account

company_shipping_address

object

Company shipping from Address, refer Shipping Address Object for parameters

customer

object

Customer (deprecated, please use Party). If there are any changes made to the customer's details, we will update those details and any documents linked to this customer's ID will be updated to reflect the changes.

customer_billing_address

object

Customer billing to Address, refer Shipping Address Object for parameters

customer_shipping_address

object

Customer shipping to Address, refer Shipping Address Object for parameters

due_date

string

DD-MM-YYYY, Payment Due date for the invoice (Ex: 11-06-2024)

einvoice

boolean

Generate einvoice

export_invoice_details

object

Export Invoice Details

export_invoice_details.conversion_factor

number

required

export_invoice_details.export_type

enum<string>

required

Export Type

Available options:

Export under bond/LUT,

Export with IGST,

SEZ with IGST Payment,

SEZ without IGST Payment,

Deemed Export

export_invoice_details.country_id

enum<string>

Country ID

Available options:

Afghanistan,

Albania,

Algeria,

Andorra,

Angola,

Antigua and Barbuda,

Argentina,

Armenia,

Australia,

Austria,

Azerbaijan,

Bahamas,

Bahrain,

Bangladesh,

Barbados,

Belarus,

Belgium,

Belize,

Benin,

Bhutan,

Bolivia,

Bosnia and Herzegovina,

Botswana,

Brazil,

Brunei,

Bulgaria,

Burkina Faso,

Burundi,

Cabo Verde,

Cambodia,

Cameroon,

Canada,

Central African Republic,

Chad,

Chile,

China,

Colombia,

Comoros,

Congo, Democratic Republic of the,

Congo, Republic of the,

Costa Rica,

Croatia,

Cuba,

Cyprus,

Czechia,

Denmark,

Djibouti,

Dominica,

Dominican Republic,

Ecuador,

Egypt,

El Salvador,

Equatorial Guinea,

Eritrea,

Estonia,

Eswatini,

Ethiopia,

Fiji,

Finland,

France,

Gabon,

Gambia,

Georgia,

Germany,

Ghana,

Greece,

Grenada,

Guatemala,

Guinea,

Guinea-Bissau,

Guyana,

Haiti,

Honduras,

Hungary,

Iceland,

India,

Indonesia,

Iran,

Iraq,

Ireland,

Israel,

Italy,

Jamaica,

Japan,

Jordan,

Kazakhstan,

Kenya,

Kiribati,

Korea, North,

Korea, South,

Kosovo,

Kuwait,

Kyrgyzstan,

Laos,

Latvia,

Lebanon,

Lesotho,

Liberia,

Libya,

Liechtenstein,

Lithuania,

Luxembourg,

Madagascar,

Malawi,

Malaysia,

Maldives,

Mali,

Malta,

Marshall Islands,

Mauritania,

Mauritius,

Mexico,

Micronesia,

Moldova,

Monaco,

Mongolia,

Montenegro,

Morocco,

Mozambique,

Myanmar,

Namibia,

Nauru,

Nepal,

Netherlands,

New Zealand,

Nicaragua,

Niger,

Nigeria,

North Macedonia,

Norway,

Oman,

Pakistan,

Palau,

Palestine,

Panama,

Papua New Guinea,

Paraguay,

Peru,

Philippines,

Poland,

Portugal,

Qatar,

Romania,

Russia,

Rwanda,

Saint Kitts and Nevis,

Saint Lucia,

Saint Vincent and the Grenadines,

Samoa,

San Marino,

Sao Tome and Principe,

Saudi Arabia,

Senegal,

Serbia,

Seychelles,

Sierra Leone,

Singapore,

Slovakia,

Slovenia,

Solomon Islands,

Somalia,

South Africa,

South Sudan,

Spain,

Sri Lanka,

Sudan,

Suriname,

Sweden,

Switzerland,

Syria,

Taiwan,

Tajikistan,

Tanzania,

Thailand,

Timor-Leste,

Togo,

Tonga,

Trinidad and Tobago,

Tunisia,

Turkey,

Turkmenistan,

Tuvalu,

Uganda,

Ukraine,

United Arab Emirates,

United Kingdom,

United States,

Uruguay,

Uzbekistan,

Vanuatu,

Vatican City,

Venezuela,

Vietnam,

Yemen,

Zambia,

Zimbabwe

export_invoice_details.shipping_bill_date

string

export_invoice_details.shipping_bill_number

string

export_invoice_details.shipping_port_code

string

extra_discount

number

Adjustment on overall invoice, doesn’t effect any tax amounts.

is_export

boolean

Is Export

is_subscription

boolean

Is Subscription

notes

string

Notes to show in invoice

party

object

Party. If there are any changes made to the party details, we will update those details and any documents linked to this party ID will be updated to reflect the changes.

party.id

string

required

Unique id for each party.

party.name

string

required

Name of the Party

party.type

enum<string>

required

Party type, use only specified values. Party type customer can be used for creating invoices, sales returns, estimates, pro forma invoices and delivery challans. Party type vendor can be used for creating purchases, purchase orders & purchase returns, .

Available options:

customer,

vendor

party.billing_address

object

Party billing to Address, refer Shipping Address Object for parameters

party.company_name

string

Company Name

party.country_code

string

Party Phone Number Country code

party.email

string

Party Email

party.gstin

string

GSTIN

party.phone_number

string

Party Phone Number

party.shipping_address

object

Party shipping to Address, refer Shipping Address Object for parameters

payments

object[]

Array of Payments, refer Payment Object for parameters

reference

string

Any references you want to add to the doc

round_off

boolean

default:

false

Should Round Off total amount

serial_number

string

Serial Number, if not sent will be auto generated based on the default prefix.

subscription_details

object

Subscription Details

tcs_id

integer

You can copy the tcs id and details mapping from https://developers.getswipe.in/api-reference/references#tcs-tax-collected-at-source

tds_id

integer

You can check the tds id and details mapping from https://developers.getswipe.in/api-reference/references#tds-tax-deducted-at-source

terms

string

Terms to show in invoice

Response

200 - application/json

einvoiceMessage

string

EInvoice Message

einvoiceSuccess

boolean

EInvoice Success

hashId

string

Hash ID

irn

string

IRN

message

string

Message

qrCode

string

QR Code

serialNumber

string

Serial Number

success

boolean

Success