Ticket Json Field Description

Main Table Field Description

PayCools External Field Name	Required	Type	Description
mchRreceiptId	Y	string	Internal receipt number (merchant internal serial number/invoice number), supports alphanumeric
numberReference	Y	string	Reference number, unique (example: `2024112501020812345678002`)
issueDateTime	Y	string (datetime)	Invoice date time, format YYYY-MM-DD hh:mm:ss, must be local time of the invoicing location
totalAmount	Y	number	Total amount = subtotal - discount + transferred taxes - withholding taxes. Cannot be negative
paymentForm	Y (conditional)	string	Payment method code (SAT catalog). For example, 01=cash
paymentMethod	Y (conditional)	string	Payment method code: PUE=single payment, PPD=installment payment
currency	Y	string	Currency code, ISO 4217, for example MXN
voucherType	Y	string	Invoice type: I=income, E=expense, T=transfer, N=payroll
issuePlace	Y	string	Invoice location postal code (headquarters or branch address)
email	N	string	Customer email, internal use only
branchKey	Y	string	Branch or store code (internal identifier)
items	Y	array	Product/service detail list

items(Conceptos) Field Description

PayCools External Field Name	Required	Type	Description
productServiceKey	Y	string	Product/service code (SAT Product and Service Catalog)
itemID	N	string	SKU/barcode/product number (merchant's own coding)
quantity	Y	number	Product/service quantity
unitKey	Y	string	Unit code (SAT Unit Catalog), for example H87=piece
unitName	N	string	Unit name (for internal display)
description	Y	string	Product/service description
unitPrice	Y	number	Unit price (excluding tax)
amount	Y	number	Amount (= quantity × unit price)
discount	N	string	Discount
taxes	N	array	Tax details (transferred/withholding)

taxes（Impuestos）Tax Detail Fields

PayCools External Field Name	Required	Type	Description
taxType	N	string	Tax type: T=transferred tax, R=withholding tax
taxBase	Y	number	Tax base amount. Usually equal to the corresponding Concepto's Importe
taxCode	Y	string	Tax code, 002=IVA
rateType	Y	string	Rate type: Tasa=rate, Cuota=fixed amount, Exento=exempt
rate	Y	number	Tax rate, for example 0.160000=16%
taxAmount	Y	number	Tax amount = Base × Tasa

Ticket Example：

{
    "mchRreceiptId": "987630",
    "numberReference": "202510131561234098711110030",
    "issueDateTime": "2025-09-22 00:01:08.00",
    "totalAmount": 264.99,
    "paymentForm": "01",
    "paymentMethod": "PUE",
    "currency": "MXN",
    "voucherType": "I",
    "issuePlace": "77503",
    "email": "haxilama@ejemplo.com",
    "branchKey": "10",
    "items": [
        {
            "productServiceKey": "90101500",
            "itemID": "202510131561234098711110001",
            "quantity": "1",
            "unitKey": "E48",
            "unitName": "UnidaddeServicio",
            "description": "xxxhaxilmawuhuwuhuwuhu:12345678FechadeConsumo2024-11-2501:02:08.000",
            "unitPrice": 228.44,
            "amount": 228.44,
            "discount": 0.0,
            "taxes": [
                {
                    "taxType": "T",
                    "taxBase": 228.44,
                    "taxCode": "002",
                    "rateType": "Tasa",
                    "rate": 0.16,
                    "taxAmount": 36.55
                }
            ]
        }
    ]
}

Example of a Ticket after base64 encoding：

ewogICAgIm1jaFJyZWNlaXB0SWQiOiAiOTg3NjMwIiwKICAgICJudW1iZXJSZWZlcmVuY2UiOiAiMjAyNTEwMTMxNTYxMjM0MDk4NzExMTEwMDMwIiwKICAgICJpc3N1ZURhdGVUaW1lIjogIjIwMjUtMDktMjIgMDA6MDE6MDguMDAiLAogICAgInRvdGFsQW1vdW50IjogMjY0Ljk5LAogICAgInBheW1lbnRGb3JtIjogIjAxIiwKICAgICJwYXltZW50TWV0aG9kIjogIlBVRSIsCiAgICAiY3VycmVuY3kiOiAiTVhOIiwKICAgICJ2b3VjaGVyVHlwZSI6ICJJIiwKICAgICJpc3N1ZVBsYWNlIjogIjc3NTAzIiwKICAgICJlbWFpbCI6ICJoYXhpbGFtYUBlamVtcGxvLmNvbSIsCiAgICAiYnJhbmNoS2V5IjogIjEwIiwKICAgICJpdGVtcyI6IFsKICAgICAgICB7CiAgICAgICAgICAgICJwcm9kdWN0U2VydmljZUtleSI6ICI5MDEwMTUwMCIsCiAgICAgICAgICAgICJpdGVtSUQiOiAiMjAyNTEwMTMxNTYxMjM0MDk4NzExMTEwMDAxIiwKICAgICAgICAgICAgInF1YW50aXR5IjogIjEiLAogICAgICAgICAgICAidW5pdEtleSI6ICJFNDgiLAogICAgICAgICAgICAidW5pdE5hbWUiOiAiVW5pZGFkZGVTZXJ2aWNpbyIsCiAgICAgICAgICAgICJkZXNjcmlwdGlvbiI6ICJ4eHhoYXhpbG1hd3VodXd1aHV3dWh1OjEyMzQ1Njc4RmVjaGFkZUNvbnN1bW8yMDI0LTExLTI1MDE6MDI6MDguMDAwIiwKICAgICAgICAgICAgInVuaXRQcmljZSI6IDIyOC40NCwKICAgICAgICAgICAgImFtb3VudCI6IDIyOC40NCwKICAgICAgICAgICAgImRpc2NvdW50IjogMC4wLAogICAgICAgICAgICAidGF4ZXMiOiBbCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgInRheFR5cGUiOiAiVCIsCiAgICAgICAgICAgICAgICAgICAgInRheEJhc2UiOiAyMjguNDQsCiAgICAgICAgICAgICAgICAgICAgInRheENvZGUiOiAiMDAyIiwKICAgICAgICAgICAgICAgICAgICAicmF0ZVR5cGUiOiAiVGFzYSIsCiAgICAgICAgICAgICAgICAgICAgInJhdGUiOiAwLjE2LAogICAgICAgICAgICAgICAgICAgICJ0YXhBbW91bnQiOiAzNi41NQogICAgICAgICAgICAgICAgfQogICAgICAgICAgICBdCiAgICAgICAgfQogICAgXQp9

Ticket

Ticket Json Field Description#

Main Table Field Description#

items(Conceptos) Field Description#

taxes（Impuestos）Tax Detail Fields#

Ticket Json Field Description

Main Table Field Description

items(Conceptos) Field Description

taxes（Impuestos）Tax Detail Fields