Invoice

Brief Description

• create or update or delete invoice data.

Request URL

• https://6409627-sb2.restlets.api.netsuite.com/app/site/hosting/restlet.nl?script=652&deploy=1

Request Method

• POST

Request Parameter Description

Parameter	Required	Type	Description	field level
operateType	True	String	Operate type, value: create,update,delete	1
docNum	True	String	The document number of the Transaction	1
documentType	True	String	The document Type of the Transaction	1
date	True	String	The Posting date of the Transaction,format of "2022/11/23"	1
dueDate	False	String	The due date of the Transaction,format of "2022/11/23"	1
customer	True	String	A customer who receives goods or services	1
employee	False	String	The employees of the transaction	1
currency	True	String	Currency of Transaction	1
exchangeRate	True	Number	The exchange rate	1
account	True	String	account of transaction	1
subsidiary	True	String	Subsidiary,Default to:"徐工俄罗斯有限责任公司（新徐俄）"	1
department	False	String	Department	1
fromLocation	False	String	location of Transaction	1
associatedDoc	False	String	The purchase order number associated with the bill	1
memo	False	String	Memos for the transaction	1
saleConNum	False	String	Sales Contract Number	1
vatInvoiceNum	False	String	Vat Invoice No.	1
vatRate	False	String	Vat rate;for example 20%	1
amount	True	Number	The total amount of a transaction	1
lines	True	Array	line property name
item	True	String	Transaction goods or service	2
quantity	True	Number	The quantity of goods in the bill or invoice	2
unit	False	String	Unit	2
unitPrice	True	Number	Unit price of goods or service	2
taxRate	True	String	Tax rate;such as 20%	2
memo	False	String	Transaction line memo	2
fromBin	False	String	bin of transaction line	2
serialNumber	False	String	batch/serial number,If there are multiple batches/serial numbers, separate them with commas,If itemType="vehicle" ,then this field is mandatory	2
itemType	True	String	If the item is a whole machine, the field is "vehicle". If the item is a spare part, the field is "spare part".If the item is service ,the field is “service”	2
serviceAccount	False	String	If the “itemType” field is “service”，this field is required， please send the income account of the service.Please transfer this field in the following format：accountCode accountName,between accountCode and accountName should be a English space,example: " 19.03 Оценочные обязательства по вознаграждениям"	2

Samples

    {
    "operateType":"create",
    "docNum": "",
    "date": "2023/02/08",
    "dueDate": "",
    "customer": "КРАНМАШ СТРОЙ ООО с 2021",
    "employee": "Крюков Николай Николаевич",
    "currency":"RUB",
    "exchangeRate":1,
    "account": "62.01",
    "subsidiary": "徐工俄罗斯有限责任公司（新徐俄）",
    "department": "отдел сервисного обслуживания",
    "fromLocation": "БП-000065",
    "associatedDoc":"",
    "memo": "",
    "saleConNum":"",
    "vatInvoiceNum":"",
    "vatRate":"20%",
    "amount"："1000",
    "lines": [{
        "item": "ZL50RU",
        "quantity": 1,
        "unit": "PCS",
        "unitPrice": 1000,
        "taxRate": "20%",
        "memo": "",
        "fromBin": "БП-000065-1",
        "serialNumber": "XUG0050GHLCB02231",
        "itemType": "vehicle"
    }]
    }

Response Parameter Description

Parameter	Type	Description
success	Boolean	true：success，false：failed
message	String	errors message
data	Array	Data

Return Samples

    // Error
    {
    "success": false,
    "message": "docNum must be filled!",
    "data": []
    }
    // Success
    {
        "success": true,
        "message": "",
        "data": [{
            "internalid" :3995
        }]
    }

Memo

• For certification information, please see Interface Certification Information