---
schema_version: "1"
id: b405c105d94f8c9c33a629dd72af32d9d8b0923959b62f0f429c8b9df2fb4795
title: JSON Sample Payloads & Schemas
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/retail-cloud/guides/json-sample-payloads-schemas.md
canonical_url: https://developer.salesforce.com/docs/commerce/retail-cloud/guide/json-sample-payloads-schemas.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 72de0237bd09aa7fa10777167987a6d8b77865600149425344948260d30d485c
products:
  - Point of Sale for Developers
  - Salesforce APIs
---
# JSON Sample Payloads & Schemas

The table provides sample JSON schemas for TLog exports. When mapping your TLog using the JSON format, follow the schema outlined in the table to ensure compatibility with your downstream systems.

**tip:** In the [reference documentation](https://developer.salesforce.com/docs/commerce/retail-cloud/references/about-retail-cloud-api/about.html), a JSON property is identified as a collection (List/Array) if, upon expansion, it displays `Any of VARIABLES`, indicating it contains a collection of that specified variable.

## Basic Orders

| **File**                                                                                                | **JSON Field**                                              | **Order Activity Log**                                                                                                                      |
| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sale Transactions**                                                                                   |                                                             |                                                                                                                                             |
| Single Item Sale <br>_Transaction involving the sale of one specific item in an order_                  | orderProductList                                            | orderActivityLog.TransactionData.orderId                                                                                                    |
| Offline Single Item <br>_Offline transaction involving the sale of one specific item in an order_       | orderProductList                                            | N/A                                                                                                                                         |
| Multi Item Sale <br>_Transaction involving the sale of multiple items in an order_                      | orderProductList                                            | N/A                                                                                                                                         |
| Sale With Customer <br>_Transaction associated with a specific customer_                                | customerProfile                                             | orderActivityLog.transactionData.profile                                                                                                    |
| **Promotions and Discounts**                                                                            |                                                             |                                                                                                                                             |
| Employee Discount <br>_Transaction with employee discount applied_                                      | orderProductList.priceAdjustments                           | orderActivityLog.transactionData.productList.productPriceAdjustment                                                                         |
| Item Level Discount <br>_Discount applied to specific items in an order_                                | orderProductList.priceAdjustments                           | orderActivityLog.transactionData.productList.productPriceAdjustment                                                                         |
| Transaction Level Discount <br>_Discount applied to the total cost of a transaction_                    | orderProductList.priceAdjustments transactionDiscountAmount | orderActivityLog.transactionData.productList.productPriceAdjustment <br>**Additional Field:** "priceAdjustmentType": "TRANSACTION_DISCOUNT" |
| Single Use Promotion Code <br>_Promotional code used once to apply discount to cart_                    | coupons                                                     | N/A                                                                                                                                         |
| Promotion <br>_Promotion applied to items or transactions_                                              | orderProductList.priceAdjustments                           | orderActivityLog.transactionData.productList.productPriceAdjustment <br>**Additional Field:** "priceAdjustmentType": "PROMOTION"            |
| **Gift Card Management**                                                                                |                                                             |                                                                                                                                             |
| Purchase Gift Card <br>_Transaction with a gift card purchase_                                          | N/A                                                         | N/A                                                                                                                                         |
| Issue With Loading Gift Cards <br>_Transaction with issues encountered when adding value to gift cards_ | orderProductList.productClass orderProductList.serialNumber | orderActivityLog.transactionData.productList.productClass                                                                                   |
| **Notes and Adjustments**                                                                               |                                                             |                                                                                                                                             |
| Item Level Note <br>_Transaction with notes applied to individual items_                                | orderProductList.notesList                                  | orderActivityLog.transactionData.productList.notesList                                                                                      |
| Order Level Note <br>_Transaction with notes applied to the entire order_                               | notesList                                                   | N/A                                                                                                                                         |
| Split Sales Attribution <br>_Transaction with sales attribution split among different employees_        | orderProductList.salesAssociateAttribution                  | orderActivityLog.transactionData.tenders                                                                                                    |
| **Tax and Billing**                                                                                     |                                                             |                                                                                                                                             |
| Tax Exempt <br>_Transaction with items that are not subjected to sales tax_                             | taxExemptions                                               | orderActivityLog.transactionData.taxExemptions                                                                                              |
| Billing <br>_Transaction with a recorded billing address_                                               | billingAddress                                              | N/A                                                                                                                                         |

## Omni Orders

| **File**                                                              | **JSON Field**                                                    | **Order Activity Log** |
| --------------------------------------------------------------------- | ----------------------------------------------------------------- | ---------------------- |
| Charge & Send <br>_In-store omni transaction_                         | fulfillmentType fulfillmentSubType shippingAddress billingAddress | N/A                    |
| Ship From Store <br>_Ship to home fom current store omni transaction_ | fulfillmentType fulfillmentsubtype shippingAddress                | N/A                    |

## Tender Payments

| **File**                                                                                            | **JSON Field**                                       | **Order Activity Log**                                                                                      |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Cash Payment <br>_Transaction completed with cash_                                                  | tenders.paymentMethod tenders.cardType               | orderActivityLog.transactionData.tenders <br>**Additional Field:** "paymentMethod": "Cash"                  |
| Credit Card Payment <br>_Transaction completed with credit card_                                    | tenders.paymentMethod tenders.cardType fundingSource | orderActivityLog.transactionData.tenders <br>**Additional Field:** "paymentMethod": "CreditCard "cardType": |
| Debit Card Payment <br>_Transaction completed with debit card_                                      | tenders.paymentMethod tenders.cardType fundingSource | orderActivityLog.transactionData.tenders <br>**Additional Field:** "paymentMethod": "CreditCard "cardType": |
| Gift Card Payment <br>_Transaction completed with gift card_                                        | tenders.paymentMethod tenders.cardType fundingSource | orderActivityLog.transactionData.tenders <br>**Additional Field:** "paymentMethod": "GiftCard"              |
| Tap to Pay <br>_Transaction completed with Tap to Pay_                                              | tenders.paymentMethod tenders.cardType fundingSource | orderActivityLog.transactionData.tenders                                                                    |
| In-Store Pay By Link <br>_Transaction completed with in-store pay by link_                          | tenders.paymentMethod tenders.cardType fundingSource | orderActivityLog.transactionData.tenders                                                                    |
| Remote Pay By Link <br>_Transaction completed with remote pay by link_                              | tenders.paymentMethod tenders.cardType fundingSource | orderActivityLog.transactionData.tenders                                                                    |
| Multi-Tender <br>_Transaction completed with more than one type of payment method_                  | tenders.paymentMethod tenders.cardType fundingSource | orderActivityLog.transactionData.tenders                                                                    |
| Miscellaneous Payment (Goodwill) <br>_Transaction completed with a miscellaneous type of Goodwill_  | tenders.paymentMethod tenders.cardType fundingSource | N/A                                                                                                         |
| Miscellaneous Payment (Deposit) <br>_Transaction completed with a miscellaneous type and a deposit_ | tenders.paymentMethod tenders.cardType fundingSource | N/A                                                                                                         |

## Returns and Exchanges

| **File**                                                                                                                                                                      | **JSON Field**    | **Order Activity Log**                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Even Exchange (original, exchange) <br>_Transaction where an item is exchanged for another item of equal value, with no additional payment or refund_                         | N/A               | orderActivityLog.transactionData.transactionType <br>originalOrderId                                                                         |
| Exchange With Extra Payment (original, exchange) <br>_Transaction where an item is exchanged for another item of higher value, and the customer pays the difference_          | N/A               | orderActivityLog.transactionData.transactionType <br>originalOrderId                                                                         |
| Exchange With Refund (original, exchange) <br>_Transaction where an item is exchanged for another item of lower value, and the customer receives a refund for the difference_ | N/A               | orderActivityLog.transactionData.transactionType <br>originalOrderId                                                                         |
| Return (gift card cash out, multi-item, single item) <br>_Transaction where a customer returns an item and receives a refund or credit_                                       | returnProductList | orderActivityLog.transactionData.returnProductList.productId                                                                                 |
| Unreferenced Even Exchange (original, new order) <br>_Even exchange transaction that is not linked to a specific previous purchase or reference number_                       | N/A               | orderActivityLog.transactionData.transactionType <br>originalOrderId <br>returnProductList <br>tenders.copiedFromOrderId <br>noReceiptReturn |
| Unreferenced Return (exchange, return) <br>_Return transaction that is not linked to a specific previous purchase or reference number_                                        | returnProductList | N/A                                                                                                                                          |

<!-- ## Unreferenced attachments:

- gift_card_cash_out_json
- single_item_return_json
- multi_item_return_json
- original_json
- new-order_json
- unreferenced_return_json
- unreferenced_exchange_json
- offline_single_item_sale_json
- employee_discount_json
- item_level_discount_json
- single_item_sale_json
- multi_item_sale_json
- sale_with_customer_json
- transaction_level_discount_json
- single_use_promo_code_json
- promotion_json
- purchase_gift_card_json
- issueload_gift_card_json
- item_level_note_json
- order_level_note_json
- split_sales_attribution_json
- tax_exempt_json
- chargesend_json
- shipfromstore_json
- cash_payment_json
- credit_card_payment_json
- debit_card_payment_json
- gift_card_payment_json
- taptopay_json
- instorepaybylink_json
- remotepaybylink_json
- split_payment_json
- original_sale_json
- misc_paymentgoodwill_json
- misc_paymentdeposit_json
- exchange_json
- original_sale_json
- exchange_json
- exchange_json
- original_sale_json
- billing_json -->