Sales: Data Attributes
Peruse further details of attributes filled-in in Sales endpoint
A sale is an event where an item is exchanged for currency.
A credit note is the reversal of a sale.
Sales and Credit notes share the same API endpoint
The attributes for sales and credit notes are mostly the same with the following difference:
- The Receipt Type code of a sale is "S" and that of a credit note is "R"
- The original_invoice_number is required in a credit note to tie it to the original sale to which the credit note is being created against.
Attributes table
| Attribute ID | Required | Data Type | Description - Sample (JSON) |
|---|---|---|---|
| sale_id (id) | (For GET (single sale), PUT and DELETE) | string | sale_id represents the UUID (Sale ID) as generated by KRA - "PFHol0bfkZ" |
| trader_invoice_number | Yes | string | Represents the Trader Invoice Number - "12345678901" |
| original_invoice_number | Only for credit note | string | Represents the Trader Invoice Number used during the sale that this credit note seeks to reverse - "12345678901" |
| invoice_number | Yes | number | Represents the Invoice Number - 1234567890 |
| receipt_type_code | Yes | string | Represents the Receipt Type Code. See Receipt Type Codes table for context - "S" |
| payment_type_code | No | string | Represents the Payment Type Code. See Payment Type Codes table - "01" |
| invoice_status_code | Yes | string | Represents the Invoice Status Code. See Invoice Status Codes table - "01" |
| items | Yes | array of objects | Represents an Array of Item Objects |
Receipt Type Codes
| Code | Code Name | Code Description |
|---|---|---|
| S | Sales | Sales |
| R | Credit Note | Credit Note (after making a sale) |
Payment Type Codes
| Code | Code Name | Code Description |
|---|---|---|
| 01 | CASH | CASH |
| 02 | CREDIT | CREDIT |
| 03 | CASH/CREDIT | CASH/CREDIT |
| 04 | BANK CHECK | BANK CHECK PAYMENT |
| 05 | DEBIT&CREDIT CARD | PAYMENT USING CARD |
| 06 | MOBILE MONEY | ANY TRANSACTION USING MOBILE MONEY SYSTEM |
| 07 | OTHER | OTHER MEANS OF PAYMENT |
Invoice Status Codes
| Code | Code Name | Code Description |
|---|---|---|
| 01 | Wait for Approval | Wait for Approval |
| 02 | Approved | Approved |
| 03 | Cancel Requested | Cancel Requested |
| 04 | Canceled | Canceled |
| 05 | "Credit Note Generated" | Credit Note Generated |
| 06 | Transferred | Transferred |
Updated about 2 months ago