| Required permission: | CustomerInvoice-Transaction.ADD |
| POST | /CustomerInvoices/Currency/simple | Create a record for Customer Invoice | AcCusInvoiceMID is a primary key |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| CustomerInvoice | body | CustomerInvoiceSimple_Currency | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| DocumentHeader | form | AcCusInvoiceMSimple_Currency | No | |
| DocumentDetails | form | List<AcCusInvoiceDSimple_Currency> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| AcCusInvoiceMID | form | NVARCHAR(20) | Yes | Invoice Number |
| AcCustomerID | form | NVARCHAR(20) | Yes | Customer ID |
| AcSalesmanID | form | NVARCHAR(20) | No | Salesman ID. Default to customer's salesman if not specified |
| AcLocationID | form | NVARCHAR(20) | Yes | Location ID |
| DocumentDate | form | DATE | Yes | Invoice Date |
| DocumentNetAmount | form | NUMERIC(18,2) | Yes | Net Amount. Before Round Cent Adjustment |
| DocumentCentBalance | form | NUMERIC(18,2) | Yes | Round Cent Adjustment Amount |
| DocumentFinalAmount | form | NUMERIC(18,2) | Yes | Final Amount. After Round Cent Adjustment |
| RefDocumentNo | form | NVARCHAR(100) | No | Reference Number |
| DocumentRemark | form | NVARCHAR(100) | No | Document Remark |
| ExtraRemark1 | form | NVARCHAR(100) | No | Extra Remark 1 |
| ExtraRemark2 | form | NVARCHAR(100) | No | Extra Remark 2 |
| ExtraRemark3 | form | NVARCHAR(100) | No | Extra Remark 3 |
| ExtraRemark4 | form | NVARCHAR(100) | No | Extra Remark 4 |
| DocumentYourReference | form | NVARCHAR(50) | No | Your Reference |
| ShipToRemark | form | NVARCHAR(100) | No | Ship To: Remark |
| ShipToShipVia | form | NVARCHAR(20) | No | Ship To: Ship Via |
| ShipToAddress1 | form | NVARCHAR(MAX) | No | Ship To: Address 1 |
| ShipToAddress2 | form | NVARCHAR(100) | No | Ship To: Address 2 |
| ShipToAddress3 | form | NVARCHAR(100) | No | Ship To: Address 3 |
| ShipToAddress4 | form | NVARCHAR(100) | No | Ship To: Address 4 |
| ShipToPhone1 | form | NVARCHAR(100) | No | Ship To: Phone 1 |
| ShipToPhone2 | form | NVARCHAR(100) | No | Ship To: Phone 1 |
| ShipToFax | form | NVARCHAR(100) | No | Ship To: Fax |
| ShipToContact1 | form | NVARCHAR(100) | No | Ship To: Contact 1 |
| ShipToContact2 | form | NVARCHAR(100) | No | Ship To: Contact 2 |
| ShipToAttention | form | NVARCHAR(100) | No | Ship To: Attention |
| AcCurrencyID | form | NVARCHAR(5) | Yes | Currency ID. Default to home currency eg: MYR |
| CurrencyRate | form | NUMERIC(18,6) | Yes | Currency Rate. Default to 1 |
| DocumentLocalItemTotalPrice | form | NUMERIC(18,2) | Yes | Total of detail.ItemTotalPrice in Local Currency |
| DocumentLocalDiscountAmount | form | NUMERIC(18,2) | Yes | Document Discount Amount in Local Currency. Always 0 |
| DocumentLocalNetAmount | form | NUMERIC(18,2) | Yes | Total of detail.ItemTotalPrice in Local Currency |
| DocumentLocalCentBalance | form | NUMERIC(18,2) | Yes | Round Cent Adjustment Amount in Local Currency. |
| DocumentLocalFinalAmount | form | NUMERIC(18,2) | Yes | Invoice Amount. Amount After Minus Round Cent |
| DocumentItemLocalGSTAmount | form | NUMERIC(18,2) | Yes | GST Amount in Local Currency. Always 0 |
| DocumentLocalItemGrossTotal | form | NUMERIC(18,2) | Yes | Total of detail.ItemGrossTotal in Local Currency |
| DocumentLocalItemGrossTotalWithGST | form | NUMERIC(18,2) | Yes | Total of detail.ItemGrossTotal in Local Currency |
| DocumentLocalItemGrossTotalWithoutGST | form | NUMERIC(18,2) | Yes | Total of detail.ItemGrossTotal in Local Currency |
| DocumentLocalItemDiscountTotalWithGST | form | NUMERIC(18,2) | Yes | Total of detail.ItemDiscountAmount in Local Currency |
| DocumentLocalItemDiscountTotalWithoutGST | form | NUMERIC(18,2) | Yes | Total of detail.ItemDiscountAmount in Local Currency |
| IsUseTransactionBuyerElement | form | NVARCHAR(100) | No | Use Transaction's Buyer Element?. True: Buyer Elements will stored based on provided value; False: Buyer Elements will stored based on Customer Profile's E-Invoice Elements |
| AcEInvoiceDocumentFlowID | form | NVARCHAR(100) | No | E-Invoice Document Flow ID. Open; Ready to Submit; Not Applicable |
| EInvoiceRegName_Buyer | form | NVARCHAR(300) | No | E-Invoice Registration Name Buyer |
| EInvoiceRegTIN_Buyer | form | NVARCHAR(40) | No | E-Invoice Registration TIN Buyer |
| EInvoiceRegNumber_Buyer | form | NVARCHAR(40) | No | E-Invoice Registration Number Buyer |
| EInvoiceBuyerIsMalaysian | form | NVARCHAR(1) | Yes | E-Invoice Buyer Is Malaysian. Y/N |
| EInvoiceBuyerRegType | form | NVARCHAR(20) | No | E-Invoice Buyer Registration Type. NRIC/BRN/PASSPORT/ARMY |
| EInvoiceRegSSTNumber_Buyer | form | NVARCHAR(40) | No | E-Invoice Registration SST Number Buyer |
| EInvoiceRegEmail_Buyer | form | NVARCHAR(320) | No | E-Invoice Registration Email Buyer |
| EInvoiceAddressLine0_Buyer | form | NVARCHAR(150) | No | E-Invoice Address Line 0 Buyer |
| EInvoiceAddressLine1_Buyer | form | NVARCHAR(150) | No | E-Invoice Address Line 1 Buyer |
| EInvoiceAddressLine2_Buyer | form | NVARCHAR(150) | No | E-Invoice Address Line 2 Buyer |
| EInvoiceAddressPostalZone_Buyer | form | NVARCHAR(50) | No | E-Invoice Address Postal Zone Buyer |
| EInvoiceAddressCityName_Buyer | form | NVARCHAR(50) | No | E-Invoice Address City Name Buyer |
| AcEInvoiceAddressStateID_Buyer | form | NVARCHAR(20) | No | E-Invoice Address State ID Buyer. 00 to 17 |
| AcEInvoiceAddressCountryID_Buyer | form | NVARCHAR(20) | No | E-Invoice Address Country ID Buyer. MYS |
| EInvoiceRegContactNumber_Buyer | form | NVARCHAR(20) | No | E-Invoice Registration Contact Number Buyer |
| IsEnableEInvoiceMYS | form | NVARCHAR(1) | No | E-Invoice Is Enabled. (Read-Only) |
| AcEInvoiceDocumentStatusID | form | NVARCHAR(40) | No | E-Invoice Document Status ID. (Read-Only). Valid;Invalid;Submitted;Cancelled |
| IsConsolidatedEInvoice | form | NVARCHAR(1) | No | E-Invoice Is Marked for Consolidated E-Invoice. Y/N. (Read-Only) |
| EInvoiceDocumentNumber_Consolidated | form | NVARCHAR(50) | No | E-Invoice Consolidated E-Invoice Document Number. (Read-Only) |
| EInvoiceSubmissionUUID | form | NVARCHAR(40) | No | E-Invoice Submission UUID. (Read-Only) |
| EInvoiceValidationUUID | form | NVARCHAR(40) | No | E-Invoice Validation UUID. (Read-Only) |
| EInvoiceValidationDateTime | form | DATETIME | No | E-Invoice Validated Datetime. (Read-Only) |
| EInvoiceValidationLink | form | NVARCHAR(MAX) | No | E-Invoice Validation Link. (Read-Only) |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| AcCusInvoiceMID | form | NVARCHAR(20) | Yes | Invoice Number |
| ItemNo | form | INT | Yes | Item Number |
| AcStockID | form | NVARCHAR(40) | Yes | Stock ID |
| AcStockUOMID | form | NVARCHAR(20) | Yes | Stock UOM ID |
| ItemUnitPrice | form | NUMERIC(18,4) | Yes | Item Unit Price |
| ItemQuantity | form | NUMERIC(18,4) | Yes | Item Quantity |
| ItemGrossTotal | form | NUMERIC(18,2) | Yes | Item Gross Total. [Item Unit Price] x [Item Quantity] |
| ItemDiscountAmount | form | NUMERIC(18,2) | Yes | Item Discount Amount |
| ItemTotalPrice | form | NUMERIC(18,2) | Yes | Item Total Price. [(Unit Price x Quantity) - Discount Amount] |
| ItemRemark1 | form | NVARCHAR(MAX) | Yes | Item Remark 1 |
| MatchIsActive | form | NVARCHAR(1) | Yes | Match Is Active. (Y/N). Default to N. If Y, please provide MatchType;MatchDocumentNo;MatchItemNo |
| MatchType | form | NVARCHAR(20) | No | Match Document Type. Valid Value: Sales Order; Delivery Order |
| MatchDocumentNo | form | NVARCHAR(20) | No | Match Document Number. |
| MatchItemNo | form | INT | Yes | Match Document Item Number. |
| ItemLocalGrossTotal | form | NUMERIC(18,2) | Yes | Item Gross Total in Local Currency. |
| ItemLocalDiscountAmount | form | NUMERIC(18,2) | Yes | Item Discount Amount in Local Currency. |
| ItemLocalTotalPrice | form | NUMERIC(18,2) | Yes | Item Total Amount in Local Currency. |
| ItemLocalGSTAmount | form | NUMERIC(18,2) | Yes | Item Taxable Amount in Local Currency |
| ItemLocalGrossTotalWithGST | form | NUMERIC(18,2) | Yes | Item Gross Total with Tax Inclusive in Local Currency |
| ItemLocalGrossTotalWithoutGST | form | NUMERIC(18,2) | Yes | Item Gross Total without Tax Inclusive in Local Currency |
| ItemLocalDiscountAmountWithGST | form | NUMERIC(18,2) | Yes | Item Discount Amount with Tax Inclusive in Local Currency |
| ItemLocalDiscountAmountWithoutGST | form | NUMERIC(18,2) | Yes | Item Discount Amount without Tax Inclusive in Local Currency |
| ItemLocalTotalPriceWithGST | form | NUMERIC(18,2) | Yes | Item Total Amount with Tax Inclusive in Local Currency |
| ItemLocalTotalPriceWithoutGST | form | NUMERIC(18,2) | Yes | Item Total Amount without Tax Inclusive in Local Currency |
| AcEInvoiceItemClassificationID | form | NVARCHAR(20) | No | E-Invoice Item Classification Code (Read-Only) |
| AcEInvoiceItemTaxTypeID | form | NVARCHAR(20) | No | E-Invoice Item Tax Type Code (Read-Only) |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /CustomerInvoices/Currency/simple HTTP/1.1
Host: snr2u.com
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<CreateCustomerInvoiceSimple_Currency xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel">
<CustomerInvoice xmlns:d2p1="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel.Types">
<d2p1:DocumentDetails xmlns:d3p1="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel.Types.CustomerInvoice">
<d3p1:AcCusInvoiceDSimple_Currency>
<d3p1:AcCusInvoiceMID>String</d3p1:AcCusInvoiceMID>
<d3p1:AcEInvoiceItemClassificationID>String</d3p1:AcEInvoiceItemClassificationID>
<d3p1:AcEInvoiceItemTaxTypeID>String</d3p1:AcEInvoiceItemTaxTypeID>
<d3p1:AcStockID>String</d3p1:AcStockID>
<d3p1:AcStockUOMID>String</d3p1:AcStockUOMID>
<d3p1:ItemDiscountAmount>0</d3p1:ItemDiscountAmount>
<d3p1:ItemGrossTotal>0</d3p1:ItemGrossTotal>
<d3p1:ItemLocalDiscountAmount>0</d3p1:ItemLocalDiscountAmount>
<d3p1:ItemLocalDiscountAmountWithGST>0</d3p1:ItemLocalDiscountAmountWithGST>
<d3p1:ItemLocalDiscountAmountWithoutGST>0</d3p1:ItemLocalDiscountAmountWithoutGST>
<d3p1:ItemLocalGSTAmount>0</d3p1:ItemLocalGSTAmount>
<d3p1:ItemLocalGrossTotal>0</d3p1:ItemLocalGrossTotal>
<d3p1:ItemLocalGrossTotalWithGST>0</d3p1:ItemLocalGrossTotalWithGST>
<d3p1:ItemLocalGrossTotalWithoutGST>0</d3p1:ItemLocalGrossTotalWithoutGST>
<d3p1:ItemLocalTotalPrice>0</d3p1:ItemLocalTotalPrice>
<d3p1:ItemLocalTotalPriceWithGST>0</d3p1:ItemLocalTotalPriceWithGST>
<d3p1:ItemLocalTotalPriceWithoutGST>0</d3p1:ItemLocalTotalPriceWithoutGST>
<d3p1:ItemNo>0</d3p1:ItemNo>
<d3p1:ItemQuantity>0</d3p1:ItemQuantity>
<d3p1:ItemRemark1>String</d3p1:ItemRemark1>
<d3p1:ItemTotalPrice>0</d3p1:ItemTotalPrice>
<d3p1:ItemUnitPrice>0</d3p1:ItemUnitPrice>
<d3p1:MatchDocumentNo>String</d3p1:MatchDocumentNo>
<d3p1:MatchIsActive>String</d3p1:MatchIsActive>
<d3p1:MatchItemNo>0</d3p1:MatchItemNo>
<d3p1:MatchType>String</d3p1:MatchType>
</d3p1:AcCusInvoiceDSimple_Currency>
</d2p1:DocumentDetails>
<d2p1:DocumentHeader xmlns:d3p1="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel.Types.CustomerInvoice">
<d3p1:AcCurrencyID>String</d3p1:AcCurrencyID>
<d3p1:AcCusInvoiceMID>String</d3p1:AcCusInvoiceMID>
<d3p1:AcCustomerID>String</d3p1:AcCustomerID>
<d3p1:AcEInvoiceAddressCountryID_Buyer>String</d3p1:AcEInvoiceAddressCountryID_Buyer>
<d3p1:AcEInvoiceAddressStateID_Buyer>String</d3p1:AcEInvoiceAddressStateID_Buyer>
<d3p1:AcEInvoiceDocumentFlowID>String</d3p1:AcEInvoiceDocumentFlowID>
<d3p1:AcEInvoiceDocumentStatusID>String</d3p1:AcEInvoiceDocumentStatusID>
<d3p1:AcLocationID>String</d3p1:AcLocationID>
<d3p1:AcSalesmanID>String</d3p1:AcSalesmanID>
<d3p1:CurrencyRate>0</d3p1:CurrencyRate>
<d3p1:DocumentCentBalance>0</d3p1:DocumentCentBalance>
<d3p1:DocumentDate>0001-01-01T00:00:00</d3p1:DocumentDate>
<d3p1:DocumentFinalAmount>0</d3p1:DocumentFinalAmount>
<d3p1:DocumentItemLocalGSTAmount>0</d3p1:DocumentItemLocalGSTAmount>
<d3p1:DocumentLocalCentBalance>0</d3p1:DocumentLocalCentBalance>
<d3p1:DocumentLocalDiscountAmount>0</d3p1:DocumentLocalDiscountAmount>
<d3p1:DocumentLocalFinalAmount>0</d3p1:DocumentLocalFinalAmount>
<d3p1:DocumentLocalItemDiscountTotalWithGST>0</d3p1:DocumentLocalItemDiscountTotalWithGST>
<d3p1:DocumentLocalItemDiscountTotalWithoutGST>0</d3p1:DocumentLocalItemDiscountTotalWithoutGST>
<d3p1:DocumentLocalItemGrossTotal>0</d3p1:DocumentLocalItemGrossTotal>
<d3p1:DocumentLocalItemGrossTotalWithGST>0</d3p1:DocumentLocalItemGrossTotalWithGST>
<d3p1:DocumentLocalItemGrossTotalWithoutGST>0</d3p1:DocumentLocalItemGrossTotalWithoutGST>
<d3p1:DocumentLocalItemTotalPrice>0</d3p1:DocumentLocalItemTotalPrice>
<d3p1:DocumentLocalNetAmount>0</d3p1:DocumentLocalNetAmount>
<d3p1:DocumentNetAmount>0</d3p1:DocumentNetAmount>
<d3p1:DocumentRemark>String</d3p1:DocumentRemark>
<d3p1:DocumentYourReference>String</d3p1:DocumentYourReference>
<d3p1:EInvoiceAddressCityName_Buyer>String</d3p1:EInvoiceAddressCityName_Buyer>
<d3p1:EInvoiceAddressLine0_Buyer>String</d3p1:EInvoiceAddressLine0_Buyer>
<d3p1:EInvoiceAddressLine1_Buyer>String</d3p1:EInvoiceAddressLine1_Buyer>
<d3p1:EInvoiceAddressLine2_Buyer>String</d3p1:EInvoiceAddressLine2_Buyer>
<d3p1:EInvoiceAddressPostalZone_Buyer>String</d3p1:EInvoiceAddressPostalZone_Buyer>
<d3p1:EInvoiceBuyerIsMalaysian>String</d3p1:EInvoiceBuyerIsMalaysian>
<d3p1:EInvoiceBuyerRegType>String</d3p1:EInvoiceBuyerRegType>
<d3p1:EInvoiceDocumentNumber_Consolidated>String</d3p1:EInvoiceDocumentNumber_Consolidated>
<d3p1:EInvoiceRegContactNumber_Buyer>String</d3p1:EInvoiceRegContactNumber_Buyer>
<d3p1:EInvoiceRegEmail_Buyer>String</d3p1:EInvoiceRegEmail_Buyer>
<d3p1:EInvoiceRegName_Buyer>String</d3p1:EInvoiceRegName_Buyer>
<d3p1:EInvoiceRegNumber_Buyer>String</d3p1:EInvoiceRegNumber_Buyer>
<d3p1:EInvoiceRegSSTNumber_Buyer>String</d3p1:EInvoiceRegSSTNumber_Buyer>
<d3p1:EInvoiceRegTIN_Buyer>String</d3p1:EInvoiceRegTIN_Buyer>
<d3p1:EInvoiceSubmissionUUID>String</d3p1:EInvoiceSubmissionUUID>
<d3p1:EInvoiceValidationDateTime>0001-01-01T00:00:00</d3p1:EInvoiceValidationDateTime>
<d3p1:EInvoiceValidationLink>String</d3p1:EInvoiceValidationLink>
<d3p1:EInvoiceValidationUUID>String</d3p1:EInvoiceValidationUUID>
<d3p1:ExtraRemark1>String</d3p1:ExtraRemark1>
<d3p1:ExtraRemark2>String</d3p1:ExtraRemark2>
<d3p1:ExtraRemark3>String</d3p1:ExtraRemark3>
<d3p1:ExtraRemark4>String</d3p1:ExtraRemark4>
<d3p1:IsConsolidatedEInvoice>String</d3p1:IsConsolidatedEInvoice>
<d3p1:IsEnableEInvoiceMYS>String</d3p1:IsEnableEInvoiceMYS>
<d3p1:IsUseTransactionBuyerElement>false</d3p1:IsUseTransactionBuyerElement>
<d3p1:RefDocumentNo>String</d3p1:RefDocumentNo>
<d3p1:ShipToAddress1>String</d3p1:ShipToAddress1>
<d3p1:ShipToAddress2>String</d3p1:ShipToAddress2>
<d3p1:ShipToAddress3>String</d3p1:ShipToAddress3>
<d3p1:ShipToAddress4>String</d3p1:ShipToAddress4>
<d3p1:ShipToAttention>String</d3p1:ShipToAttention>
<d3p1:ShipToContact1>String</d3p1:ShipToContact1>
<d3p1:ShipToContact2>String</d3p1:ShipToContact2>
<d3p1:ShipToFax>String</d3p1:ShipToFax>
<d3p1:ShipToPhone1>String</d3p1:ShipToPhone1>
<d3p1:ShipToPhone2>String</d3p1:ShipToPhone2>
<d3p1:ShipToRemark>String</d3p1:ShipToRemark>
<d3p1:ShipToShipVia>String</d3p1:ShipToShipVia>
</d2p1:DocumentHeader>
</CustomerInvoice>
</CreateCustomerInvoiceSimple_Currency>