Posted sales invoice inbound APIs
The Posted Sales Invoice in MS Dynamics Business Central ERP records the details of a completed sales transaction. Posted sales invoice serves as a formal billing document issued by the seller to the customer, confirming the sale of goods or services and requesting payment.
- Transform Name:
- STD_MSDynamics_Business_PostedSalesInvoice_IB
The following are the MS Dynamics Business Central ERP attributes that are mapped with the Canonical attributes and their output path.
| MS Dynamics Field Input Element | Mapped Canonical Path | Target Output Element | Mapping Rules | |
|---|---|---|---|---|
| @odata.context | Not mapped | Not mapped | – | |
| @odata.etag | Not mapped | Not mapped | – | |
| id | Not mapped | Not mapped | – | |
| number | data/messageBody/canonicalInvoiceHeader/transactionReferenceIdentifierList
|
b2bTransactionIdentifierValue | Where b2bTransactionIdentifierType= INVOICE | |
| externalDocumentNumber | data/messageBody/canonicalInvoiceHeader/transactionReferenceIdentifierList
|
b2bTransactionIdentifierValue | Hard code "PURCHASEORDER" to target instance of transactionReferenceIdentifierList | |
| invoiceDate | data/messageBody/canonicalInvoiceHeader/invoiceDates
data/messageBody/canonicalnvoiceHeader / transactionReferenceIdentifierList
|
dateValue transactionDate |
where dateType= "INVOICE" where b2bTransactionIdentifierType = INVOICE |
|
| postingDate | Not mapped | Not mapped | – | |
| dueDate | Not mapped | Not mapped | – | |
| promisedPayDate | Not mapped | Not mapped | – | |
| customerPurchaseOrderReference | Not mapped | Not mapped | – | |
| customerId | Not mapped | Not mapped | – | |
| customerNumber | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/mpcCompanyLocationIdentifierList
|
companyIdentifierValue | where companyIdentifierType = COMPANYID | |
| customerName | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation
|
businessName | – | |
| billToName | data/messageBody/canonicalInvoiceHeader/billToBusinessInformation |
businessName | – | |
| billToCustomerId | Not mapped | Not mapped | – | |
| billToCustomerNumber | data/messageBody/canonicalInvoiceHeader/billToBusinessInformation/mpcCompanyLocationIdentifierList
|
companyIdentifierValue | where companyIdentifierType = COMPANYID | |
| shipToName | data/messageBody/canonicalInvoiceHeader/shipToLocationInformation
|
businessName | – | |
| shipToContact | data/messageBody/canonicalInvoiceHeader/shipToLocationInformation/companyLocationContactInformation
|
contactName | – | |
| sellToAddressLine1 | Not mapped | Not mapped | – | |
| sellToAddressLine2 | Not mapped | Not mapped | – | |
| sellToCity | Not mapped | Not mapped | – | |
| sellToCountry | Not mapped | Not mapped | – | |
| sellToState | Not mapped | Not mapped | – | |
| sellToPostCode | Not mapped | Not mapped | – | |
| billToAddressLine1 | data/messageBody/canonicalInvoiceHeader/billToBusinessInformation/address
|
address1 | – | |
| billToAddressLine2 | data/messageBody/canonicalInvoiceHeader/billToBusinessInformation/address
|
address2 | – | |
| billToCity | data/messageBody/canonicalInvoiceHeader/billToBusinessInformation/address
|
city | – | |
| billToCountry | data/messageBody/canonicalInvoiceHeader/billToBusinessInformation/address
|
country | – | |
| billToState | data/messageBody/canonicalInvoiceHeader/billToBusinessInformation/address |
state | – | |
| billToPostCode | data/messageBody/canonicalInvoiceHeader/billToBusinessInformation/address
|
postalCode | – | |
| shipToAddressLine1 | data/messageBody/canonicalInvoiceHeader/shipToLocationInformation/address |
address1 | – | |
| shipToAddressLine2 | data/messageBody/canonicalInvoiceHeader/shipToLocationInformation/address |
address2 | – | |
| shipToCity | data/messageBody/canonicalInvoiceHeader/shipToLocationInformation/address
|
city | – | |
| shipToCountry | data/messageBody/canonicalInvoiceHeader/shipToLocationInformation/address |
country | – | |
| shipToState | data/messageBody/canonicalInvoiceHeader/shipToLocationInformation/address |
state | – | |
| shipToPostCode | data/messageBody/canonicalInvoiceHeader/shipToLocationInformation/address
|
postalCode | – | |
| currencyId | Not mapped | Not mapped | – | |
| shortcutDimension1Code | Not mapped | Not mapped | – | |
| shortcutDimension2Code | Not mapped | Not mapped | – | |
| currencyCode | data/messageBody/canonicalInvoiceHeader/invoiceCurrency
|
currencyCode | – | |
| orderId | Not mapped | Not mapped | – | |
| orderNumber | data/messageBody/canonicalInvocieHeader/transactionReferenceIdentifierList
|
b2bTransactionIdentifierValue | Hard code "ORDERNUMBER" to target instance of transactionReferenceIdentifierList | |
| paymentTermsId | Not mapped | Not mapped | – | |
| shipmentMethodId | Not mapped | Not mapped | – | |
| salesperson | Not mapped | Not mapped | – | |
| disputeStatusId | Not mapped | Not mapped | – | |
| disputeStatus | Not mapped | Not mapped | – | |
| pricesIncludeTax | Not mapped | Not mapped | – | |
| remainingAmount | Not mapped | Not mapped | – | |
| discountAmount | data/messageBody/canonicalInvoiceHeader/creditsAndCharges
|
creditChargeAmount | Where creditChargeType= DISCOUNT | |
| discountAppliedBeforeTax | Not mapped | Not mapped | – | |
| totalAmountExcludingTax | Not mapped | Not mapped | – | |
| totalTaxAmount | Not mapped | Not mapped | – | |
| totalAmountIncludingTax | Not mapped | Not mapped | – | |
| status | Not mapped | Not mapped | – | |
| lastModifiedDateTime | Not mapped | Not mapped | – | |
| phoneNumber | Not mapped | Not mapped | – | |
| Not mapped | Not mapped | – | ||
| shipToAddressLine1 | data/messageBody/canonicalInvoiceHeader/remitToBusinessInformation/address
|
address1 | – | |
| shipToAddressLine2 | data/messageBody/canonicalInvoiceHeader/remitToBusinessInformation/address
|
address2 | – | |
| shipToCity | data/messageBody/canonicalInvoiceHeader/remitToBusinessInformation/address
|
city | – | |
| shipToCountry | data/messageBody/canonicalInvoiceHeader/remitToBusinessInformation/address
|
country | – | |
| shipToState | data/messageBody/canonicalInvoiceHeader/remitToBusinessInformation/address
|
state | – | |
| shipToPostCode | data/messageBody/canonicalInvoiceHeader/remitToBusinessInformation/address
|
postalCode | – | |
| customerNumber | data/messageBody/canonicalInvoiceHeader/remitToBusinessInformation/mpcCompanyLocationIdentifierList
|
companyIdentifierValue | where companyIdentifierType = COMPANYSITEID | |
| customer | – | |||
| @odata.etag | Not mapped | Not mapped | – | |
| id | Not mapped | Not mapped | – | |
| number | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/mpcCompanyLocationIdentifierList
|
companyIdentifierValue | where companyIdentifierType = COMPANYID | |
| displayName | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation
|
businessName | – | |
| type | Not mapped | Not mapped | – | |
| addressLine1 | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/address
|
address1 | – | |
| addressLine2 | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/address
|
address2 | – | |
| city | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/address
|
city | – | |
| state | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/address
|
country | – | |
| country | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/address
|
state | – | |
| postalCode | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/address
|
postalCode | – | |
| phoneNumber | data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/companyLocationContactInformation
|
contactPhone | – | |
data/messageBody/canonicalInvoiceHeader/customerBusinessInformation/companyLocationContactInformation
|
contactEmail | – | ||
| website | Not mapped | Not mapped | – | |
| salespersonCode | Not mapped | Not mapped | – | |
| balanceDue | Not mapped | Not mapped | – | |
| creditLimit | Not mapped | Not mapped | – | |
| taxLiable | Not mapped | Not mapped | – | |
| taxAreaId | Not mapped | Not mapped | – | |
| taxAreaDisplayName | Not mapped | Not mapped | – | |
| taxRegistrationNumber | Not mapped | Not mapped | – | |
| currencyId | Not mapped | Not mapped | – | |
| currencyCode | Not mapped | Not mapped | – | |
| paymentTermsId | Not mapped | Not mapped | – | |
| shipmentMethodId | Not mapped | Not mapped | – | |
| paymentMethodId | Not mapped | Not mapped | – | |
| blocked | Not mapped | Not mapped | – | |
| lastModifiedDateTime | Not mapped | Not mapped | – | |
| currency | Not mapped | Not mapped | – | |
| dimensionValue | Not mapped | Not mapped | – | |
| paymentTerm | – | |||
| @odata.etag | Not mapped | Not mapped | – | |
| id | Not mapped | Not mapped | – | |
| code | data/messageBody/canonicalInvoiceHeader/termsOfPayment
|
paymentTermCode | – | |
| displayName | Not mapped | Not mapped | – | |
| dueDateCalculation | Not mapped | Not mapped | – | |
| discountDateCalculation | Not mapped | Not mapped | – | |
| discountPercent | data/messageBody/canonicalInvoiceHeader/termsOfPayment
|
termsOfPaymentPercent | – | |
| calculateDiscountOnCreditMemos | Not mapped | Not mapped | – | |
| lastModifiedDateTime | Not mapped | Not mapped | – | |
| shipmentMethod | Not mapped | Not mapped | – | |
| dimensionSetLines | – | |||
| @odata.etag | Not mapped | Not mapped | – | |
| id | Not mapped | Not mapped | – | |
| code | Not mapped | Not mapped | – | |
| consolidationCode | Not mapped | Not mapped | – | |
| parentId | Not mapped | Not mapped | – | |
| parentType | Not mapped | Not mapped | – | |
| displayName | Not mapped | Not mapped | – | |
| valueId | Not mapped | Not mapped | – | |
| valueCode | Not mapped | Not mapped | – | |
| valueConsolidationCode | Not mapped | Not mapped | – | |
| valueDisplayName | Not mapped | Not mapped | – | |
| salesInvoiceLines | Not mapped | – | ||
| @odata.etag | Not mapped | Not mapped | – | |
| id | Not mapped | Not mapped | – | |
| documentId | Not mapped | Not mapped | – | |
| sequence | data/messageBody/canonicalInvoiceItemDetails
|
lineItemNumber | – | |
| itemId | Not mapped | Not mapped | – | |
| accountId | Not mapped | Not mapped | – | |
| lineType | Not mapped | ITEM | Hard Code to ITEM | |
| lineObjectNumber | data/messageBody/canonicalInvoiceItemDetails/productCodesIdentifiers |
productCodeValue | productCodeType=VENDOR | |
| description | data|messageBody/canonicalInvoiceItemDetails/productItemInformation
|
productDescription | Add Same Value in productName field too | |
| description2 | Not mapped | Not mapped | – | |
| unitOfMeasureId | Not mapped | Not mapped | – | |
| unitOfMeasureCode | data/messageBody/canonicalInvoiceItemDetails/additionalItemInformation
data/messageBody/canonicalInvoiceItemDetails/itemQuantity
|
unitOfMeasure | Only Each and Case are allowed | |
| quantity | data/messageBody/canonicalInvoiceItemDetails/itemQuantity
|
quantityValue | quantityType = INVOICE | |
| unitPrice | data/messageBody/canonicalInvoiceItemDetails/invoicePricing
|
pricingAmount | where pricingType=UNIT | |
| discountAmount | data/messageBody/canonicalInvoiceItemDetails/creditsAndCharges
|
creditChargeAmount | where creditChargeType= DISCOUNT | |
| discountPercent | data/messageBody/canonicalInvoiceItemDetails/creditsAndCharges
|
creditChargePercentRate | – | |
| discountAppliedBeforeTax | Not mapped | Not mapped | – | |
| amountExcludingTax | Not mapped | Not mapped | – | |
| taxCode | Not mapped | Not mapped | – | |
| taxPercent | Not mapped | Not mapped | – | |
| totalTaxAmount | Not mapped | Not mapped | – | |
| amountIncludingTax | Not mapped | Not mapped | – | |
| invoiceDiscountAllocation | Not mapped | Not mapped | – | |
| netAmount | data/messageBody/canonicalInvoiceItemDetails/invoicePricing
|
pricingAmount | where pricingType=NET | |
| netTaxAmount | Not mapped | Not mapped | – | |
| netAmountIncludingTax | data/messageBody/canonicalInvoiceItemDetails/invoicePricing
|
pricingAmount | where pricingType=TOTAL | |
| shipmentDate | Not mapped | Not mapped | – | |
| itemVariantId | Not mapped | Not mapped | – | |
| locationId | Not mapped | Not mapped | – | |
| vendor | ||||
| @odata.context | Not mapped | Not mapped | – | |
| id | data/messageBody/canonicalInvoiceHeader/supplierBusinessInformation/mpcCompanyLocationIdentifierList
|
companyIdentifierValue | companyIdentifierType=COMPANYID | |
| systemVersion | Not mapped | Not mapped | – | |
| timestamp | Not mapped | Not mapped | – | |
| name | Not mapped | Not mapped | – | |
| displayName | data/messageBody/canonicalInvoiceHeader/supplierBusinessInformation
|
businessName | – | |
| businessProfileId | Not mapped | Not mapped | – | |
| systemCreatedAt | Not mapped | Not mapped | – | |
| systemCreatedBy | Not mapped | Not mapped | – | |
| systemModifiedAt | Not mapped | Not mapped | – | |
| systemModifiedBy | Not mapped | Not mapped | – | |
