SmartAcc DynaMod Web API v2024.4 Build 0000 - Local

<back to all web services

SupplierInvoicesSimple

Supplier Module - Transaction

Supplier Invoice API

Requires Authentication
Required permission:SupplierInvoice-Transaction.GET
The following routes are available for this service:
GET/SupplierInvoices/simple
GET/SupplierInvoices/simple/page/{Page}Get records by given a page numberEach page consists of 20 records
GET/SupplierInvoices/simple/Invoice/{AcSupInvoiceMID}Get a record by given a Document NumberHeader and Detail record would be return if found.
GET/SupplierInvoices/simple/Invoice/{fromDate}/{toDate}Get a record by given a Document DateDate format yyyy-MM-dd
GET/SupplierInvoices/simple/EditDate/{fromEditDate}/{toEditDate}Get a record by given a Edit DateDate format yyyy-MM-dd
SupplierInvoicesSimple Parameters:
NameParameterData TypeRequiredDescription
Pagepathint?No
AcSupInvoiceMIDpathstringNo
fromDatepathstringNo
toDatepathstringNo
fromEditDatepathstringNo
toEditDatepathstringNo
SupplierInvoicesSimpleResponse Parameters:
NameParameterData TypeRequiredDescription
InvoicesformList<SupplierInvoiceSimple>No
ResponseStatusformResponseStatusNo
SupplierInvoiceSimple Parameters:
NameParameterData TypeRequiredDescription
DocumentHeaderformAcSupInvoiceMSimpleNo
DocumentDetailsformList<AcSupInvoiceDSimple>No
AcSupInvoiceMSimple Parameters:
NameParameterData TypeRequiredDescription
AcSupInvoiceMIDformNVARCHAR(20)YesInvoice Number
AcSupplierIDformNVARCHAR(20)YesSupplier ID
AcLocationIDformNVARCHAR(20)YesLocation ID
SupplierInvoiceNumberformNVARCHAR(20)YesSupplier Invoice Number
DocumentDateformDATEYesInvoice Date
DocumentNetAmountformNUMERIC(18,2)YesNet Amount. Before Round Cent Adjustment
DocumentCentBalanceformNUMERIC(18,2)YesRound Cent Adjustment Amount
DocumentFinalAmountformNUMERIC(18,2)YesFinal Amount. After Round Cent Adjustment
RefDocumentNoformNVARCHAR(100)NoReference Number
DocumentRemarkformNVARCHAR(100)NoDocument Remark
ExtraRemark1formNVARCHAR(100)NoExtra Remark 1
ExtraRemark2formNVARCHAR(100)NoExtra Remark 2
ExtraRemark3formNVARCHAR(100)NoExtra Remark 3
ExtraRemark4formNVARCHAR(100)NoExtra Remark 4
EditDateformDATETIMEYesEdit Date
IsUseTransactionSupplierElementformBooleanNoUse Transaction's Supplier Element?. True: Supplier Elements will stored based on provided value; False: Supplier Elements will stored based on Supplier Profile's E-Invoice Elements
AcEInvoiceDocumentFlowIDformNVARCHAR(100)NoE-Invoice Document Flow ID. Open; Ready to Submit; Not Applicable
EInvoiceRegName_SupplierformNVARCHAR(300)NoE-Invoice Registration Name Supplier
EInvoiceRegTIN_SupplierformNVARCHAR(40)NoE-Invoice Registration TIN Supplier
EInvoiceRegNumber_SupplierformNVARCHAR(40)NoE-Invoice Registration Number Supplier
EInvoiceSupplierIsMalaysianformNVARCHAR(1)YesE-Invoice Supplier Is Malaysian. Y/N
EInvoiceSupplierRegTypeformNVARCHAR(20)NoE-Invoice Supplier Registration Type. NRIC/BRN/PASSPORT/ARMY
EInvoiceRegSSTNumber_SupplierformNVARCHAR(40)NoE-Invoice Registration SST Number Supplier
EInvoiceRegTourismTaxRegNumber_SupplierformNVARCHAR(40)NoE-Invoice Tourism Tax Registration Number Supplier
EInvoiceRegEmail_SupplierformNVARCHAR(320)NoE-Invoice Registration Email Supplier
AcEInvoiceSupplierMSICID_SupplierformNVARCHAR(5)NoE-Invoice MSIC Code Supplier
EInvoiceRegBusinessActivityDescription_SupplierformNVARCHAR(300)NoE-Invoice Business Activity Description (MSIC) Supplier
EInvoiceAddressLine0_SupplierformNVARCHAR(150)NoE-Invoice Address Line 0 Supplier
EInvoiceAddressLine1_SupplierformNVARCHAR(150)NoE-Invoice Address Line 1 Supplier
EInvoiceAddressLine2_SupplierformNVARCHAR(150)NoE-Invoice Address Line 2 Supplier
EInvoiceAddressPostalZone_SupplierformNVARCHAR(50)NoE-Invoice Address Postal Zone Buyer
EInvoiceAddressCityName_SupplierformNVARCHAR(50)NoE-Invoice Address City Name Supplier
AcEInvoiceAddressStateID_SupplierformNVARCHAR(20)NoE-Invoice Address State ID Supplier. 00 to 17
AcEInvoiceAddressCountryID_SupplierformNVARCHAR(20)NoE-Invoice Address Country ID Supplier. MYS
EInvoiceRegContactNumber_SupplierformNVARCHAR(20)NoE-Invoice Registration Contact Number Supplier
IsEnableEInvoiceMYSformNVARCHAR(1)NoE-Invoice Is Enabled. (Read-Only)
AcEInvoiceDocumentStatusIDformNVARCHAR(40)NoE-Invoice Document Status ID. (Read-Only). Valid;Invalid;Submitted;Cancelled
IsConsolidatedEInvoiceformNVARCHAR(1)NoE-Invoice Is Marked for Consolidated E-Invoice. Y/N. (Read-Only)
EInvoiceDocumentNumber_ConsolidatedformNVARCHAR(50)NoE-Invoice Consolidated E-Invoice Document Number. (Read-Only)
EInvoiceSubmissionUUIDformNVARCHAR(40)NoE-Invoice Submission UUID. (Read-Only)
EInvoiceValidationUUIDformNVARCHAR(40)NoE-Invoice Validation UUID. (Read-Only)
EInvoiceValidationDateTimeformDATETIMENoE-Invoice Validated Datetime. (Read-Only)
EInvoiceValidationLinkformNVARCHAR(MAX)NoE-Invoice Validation Link. (Read-Only)
AcSupInvoiceDSimple Parameters:
NameParameterData TypeRequiredDescription
AcSupInvoiceMIDformNVARCHAR(20)YesInvoice Number
ItemNoformINTYesItem Number
AcStockIDformNVARCHAR(40)YesStock ID
AcStockUOMIDformNVARCHAR(20)YesStock UOM ID
ItemUnitPriceformNUMERIC(18,4)YesItem Unit Price
ItemQuantityformNUMERIC(18,4)YesItem Quantity
ItemGrossTotalformNUMERIC(18,2)YesItem Gross Total. [Item Unit Price] x [Item Quantity]
ItemDiscountAmountformNUMERIC(18,2)YesItem Discount Amount
ItemTotalPriceformNUMERIC(18,2)YesItem Total Price. [(Unit Price x Quantity) - Discount Amount]
ItemRemark1formNVARCHAR(MAX)YesItem Remark 1
MatchIsActiveformNVARCHAR(1)YesMatch Is Active. (Y/N). Default to N. If Y, please provide MatchType;MatchDocumentNo;MatchItemNo
MatchTypeformNVARCHAR(20)NoMatch Document Type. Valid Value: Sales Order; Delivery Order
MatchDocumentNoformNVARCHAR(20)NoMatch Document Number.
MatchItemNoformINTYesMatch Document Item Number.
AcSupInvoiceDSerialSimpleformListNoSupplier Invoice Serial List.
AcEInvoiceItemClassificationIDformNVARCHAR(20)NoE-Invoice Item Classification Code (Read-Only)
AcEInvoiceItemTaxTypeIDformNVARCHAR(20)NoE-Invoice Item Tax Type Code (Read-Only)
AcSupInvoiceDSerialSimple Parameters:
NameParameterData TypeRequiredDescription
AcSupInvoiceDSerialIDformNVARCHAR(40)YesPrimary Key
AcSupInvoiceMIDformNVARCHAR(20)YesSupplier Invoice Number
ItemNoformINTEGERYesItem Number (Referred to AcSupInvoiceD.ItemNo)
AcStockIDformNVARCHAR(20)NoStock ID
AcStockUOMIDformNVARCHAR(20)NoStock UOM ID
StockSerialNumberformNVARCHAR(40)YesStock Serial Number
ItemQuantityformINTNoItem Quantity. Always 1.

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /SupplierInvoices/simple HTTP/1.1 
Host: snr2u.com 
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<SupplierInvoicesSimpleResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel">
  <Invoices xmlns:d2p1="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel.Types">
    <d2p1:SupplierInvoiceSimple>
      <d2p1:DocumentDetails xmlns:d4p1="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel.Types.SupplierInvoice">
        <d4p1:AcSupInvoiceDSimple>
          <d4p1:AcEInvoiceItemClassificationID>String</d4p1:AcEInvoiceItemClassificationID>
          <d4p1:AcEInvoiceItemTaxTypeID>String</d4p1:AcEInvoiceItemTaxTypeID>
          <d4p1:AcStockID>String</d4p1:AcStockID>
          <d4p1:AcStockUOMID>String</d4p1:AcStockUOMID>
          <d4p1:AcSupInvoiceDSerialSimple>
            <d4p1:AcSupInvoiceDSerialSimple>
              <d4p1:AcStockID>String</d4p1:AcStockID>
              <d4p1:AcStockUOMID>String</d4p1:AcStockUOMID>
              <d4p1:AcSupInvoiceDSerialID>String</d4p1:AcSupInvoiceDSerialID>
              <d4p1:AcSupInvoiceMID>String</d4p1:AcSupInvoiceMID>
              <d4p1:ItemNo>0</d4p1:ItemNo>
              <d4p1:ItemQuantity>0</d4p1:ItemQuantity>
              <d4p1:StockSerialNumber>String</d4p1:StockSerialNumber>
            </d4p1:AcSupInvoiceDSerialSimple>
          </d4p1:AcSupInvoiceDSerialSimple>
          <d4p1:AcSupInvoiceMID>String</d4p1:AcSupInvoiceMID>
          <d4p1:ItemDiscountAmount>0</d4p1:ItemDiscountAmount>
          <d4p1:ItemGrossTotal>0</d4p1:ItemGrossTotal>
          <d4p1:ItemNo>0</d4p1:ItemNo>
          <d4p1:ItemQuantity>0</d4p1:ItemQuantity>
          <d4p1:ItemRemark1>String</d4p1:ItemRemark1>
          <d4p1:ItemTotalPrice>0</d4p1:ItemTotalPrice>
          <d4p1:ItemUnitPrice>0</d4p1:ItemUnitPrice>
          <d4p1:MatchDocumentNo>String</d4p1:MatchDocumentNo>
          <d4p1:MatchIsActive>String</d4p1:MatchIsActive>
          <d4p1:MatchItemNo>0</d4p1:MatchItemNo>
          <d4p1:MatchType>String</d4p1:MatchType>
        </d4p1:AcSupInvoiceDSimple>
      </d2p1:DocumentDetails>
      <d2p1:DocumentHeader xmlns:d4p1="http://schemas.datacontract.org/2004/07/SmartDynaModWebAPI.ServiceModel.Types.SupplierInvoice">
        <d4p1:AcEInvoiceAddressCountryID_Supplier>String</d4p1:AcEInvoiceAddressCountryID_Supplier>
        <d4p1:AcEInvoiceAddressStateID_Supplier>String</d4p1:AcEInvoiceAddressStateID_Supplier>
        <d4p1:AcEInvoiceDocumentFlowID>String</d4p1:AcEInvoiceDocumentFlowID>
        <d4p1:AcEInvoiceDocumentStatusID>String</d4p1:AcEInvoiceDocumentStatusID>
        <d4p1:AcEInvoiceSupplierMSICID_Supplier>String</d4p1:AcEInvoiceSupplierMSICID_Supplier>
        <d4p1:AcLocationID>String</d4p1:AcLocationID>
        <d4p1:AcSupInvoiceMID>String</d4p1:AcSupInvoiceMID>
        <d4p1:AcSupplierID>String</d4p1:AcSupplierID>
        <d4p1:DocumentCentBalance>0</d4p1:DocumentCentBalance>
        <d4p1:DocumentDate>0001-01-01T00:00:00</d4p1:DocumentDate>
        <d4p1:DocumentFinalAmount>0</d4p1:DocumentFinalAmount>
        <d4p1:DocumentNetAmount>0</d4p1:DocumentNetAmount>
        <d4p1:DocumentRemark>String</d4p1:DocumentRemark>
        <d4p1:EInvoiceAddressCityName_Supplier>String</d4p1:EInvoiceAddressCityName_Supplier>
        <d4p1:EInvoiceAddressLine0_Supplier>String</d4p1:EInvoiceAddressLine0_Supplier>
        <d4p1:EInvoiceAddressLine1_Supplier>String</d4p1:EInvoiceAddressLine1_Supplier>
        <d4p1:EInvoiceAddressLine2_Supplier>String</d4p1:EInvoiceAddressLine2_Supplier>
        <d4p1:EInvoiceAddressPostalZone_Supplier>String</d4p1:EInvoiceAddressPostalZone_Supplier>
        <d4p1:EInvoiceDocumentNumber_Consolidated>String</d4p1:EInvoiceDocumentNumber_Consolidated>
        <d4p1:EInvoiceRegBusinessActivityDescription_Supplier>String</d4p1:EInvoiceRegBusinessActivityDescription_Supplier>
        <d4p1:EInvoiceRegContactNumber_Supplier>String</d4p1:EInvoiceRegContactNumber_Supplier>
        <d4p1:EInvoiceRegEmail_Supplier>String</d4p1:EInvoiceRegEmail_Supplier>
        <d4p1:EInvoiceRegName_Supplier>String</d4p1:EInvoiceRegName_Supplier>
        <d4p1:EInvoiceRegNumber_Supplier>String</d4p1:EInvoiceRegNumber_Supplier>
        <d4p1:EInvoiceRegSSTNumber_Supplier>String</d4p1:EInvoiceRegSSTNumber_Supplier>
        <d4p1:EInvoiceRegTIN_Supplier>String</d4p1:EInvoiceRegTIN_Supplier>
        <d4p1:EInvoiceRegTourismTaxRegNumber_Supplier>String</d4p1:EInvoiceRegTourismTaxRegNumber_Supplier>
        <d4p1:EInvoiceSubmissionUUID>String</d4p1:EInvoiceSubmissionUUID>
        <d4p1:EInvoiceSupplierIsMalaysian>String</d4p1:EInvoiceSupplierIsMalaysian>
        <d4p1:EInvoiceSupplierRegType>String</d4p1:EInvoiceSupplierRegType>
        <d4p1:EInvoiceValidationDateTime>0001-01-01T00:00:00</d4p1:EInvoiceValidationDateTime>
        <d4p1:EInvoiceValidationLink>String</d4p1:EInvoiceValidationLink>
        <d4p1:EInvoiceValidationUUID>String</d4p1:EInvoiceValidationUUID>
        <d4p1:EditDate>0001-01-01T00:00:00</d4p1:EditDate>
        <d4p1:ExtraRemark1>String</d4p1:ExtraRemark1>
        <d4p1:ExtraRemark2>String</d4p1:ExtraRemark2>
        <d4p1:ExtraRemark3>String</d4p1:ExtraRemark3>
        <d4p1:ExtraRemark4>String</d4p1:ExtraRemark4>
        <d4p1:IsConsolidatedEInvoice>String</d4p1:IsConsolidatedEInvoice>
        <d4p1:IsEnableEInvoiceMYS>String</d4p1:IsEnableEInvoiceMYS>
        <d4p1:IsUseTransactionSupplierElement>false</d4p1:IsUseTransactionSupplierElement>
        <d4p1:RefDocumentNo>String</d4p1:RefDocumentNo>
        <d4p1:SupplierInvoiceNumber>String</d4p1:SupplierInvoiceNumber>
      </d2p1:DocumentHeader>
    </d2p1:SupplierInvoiceSimple>
  </Invoices>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
</SupplierInvoicesSimpleResponse>