LPO Transactions

The SaveLpoInvoiceAsync() method allows taxpayers to submit sales transactions based on Local Purchase Orders (LPOs).

A valid combination of seller TPIN, customer TPIN, and LPO number must be used, as registered on TaxOnline. LPO transactions also require correct tax category assignment (e.g., Zero-Rating for certain LPOs).

SaveLpoInvoiceAsync() method

This method is used to process an LPO transaction. It ensures the sale is properly linked to the LPO number and the correct tax treatment is applied.

It is particularly useful for bulk or contract sales where an LPO is the reference document.

Request Parameters

Parameter	Type	Description
CISInvoiceNumber	string	Unique invoice number for the LPO transaction
CustomerTPIN	string	Customer TPIN
CustomerName	string	Customer name
SalesTypeCode	string	“N” for normal sale
ReceiptTypeCode	string	“S” for standard receipt
PaymentTypeCode	string	Payment method code (e.g., “01” for cash)
SalesStatusCode	string	Status code for the sale
ConfirmationDateTime	string	Date/time of confirmation (yyyyMMddHHmmss)
SalesDate	string	Date of sale (yyyyMMdd)
TotalItemCount	int	Total number of items
LPONumber	string	Local Purchase Order number
ItemList	list	List of items included, with VAT category and taxable amounts updated for LPO
TaxableAmountA	decimal	Taxable amount for standard VAT (if any)
TaxAmountA	decimal	VAT amount for standard VAT (if any)
TaxableAmountC2	decimal	Taxable amount for Zero-Rated VAT
TaxAmountC2	decimal	VAT amount for Zero-Rated VAT (typically 0)
TotalTaxableAmount	decimal	Total taxable amount across all items
TotalTaxAmount	decimal	Total tax amount across all items
TotalAmount	decimal	Total amount including tax

Usage Example

Example Successful Response

{
  "resultCd": "000",
  "resultMsg": "It is succeeded",
  "resultDt": "20250911104500",
  "data": {
    "rcptNo": 12,
    "intrlData": "SZ6IAX5JHVUAWTMG3RHWSCKGFU",
    "rcptSign": "F3C5AKPZCD7PXO6G",
    "vsdcRcptPbctDate": "20250911104500",
    "sdcId": "SDC0010002702",
    "mrcNo": "WIS00003710",
    "qrCodeUrl": "https://sandboxportal.zra.org.zm/indexInvoiceData?Data=1002890781000F3C5AKPZCD7PXO6G"
  }
}