Ticket Json格式字段说明

主表字段说明

PayCools对外字段名	必填	类型	说明
mchRreceiptId	Y	string	内部票据编号（商户内部流水号/发票号），支持字母数字
numberReference	Y	string	编号参考，唯一（示例：`2024112501020812345678002`）
issueDateTime	Y	string (datetime)	开票日期时间，格式 YYYY-MM-DD hh:mm:ss，必须是开票地的本地时间
totalAmount	Y	number	总金额 = 小计 - 折扣 + 转嫁税费 - 预扣税。不能为负数
paymentForm	Y (条件)	string	支付方式代码（SAT 目录）。如 01=现金
paymentMethod	Y (条件)	string	支付方法代码：PUE=一次性支付，PPD=分期付款
currency	Y	string	货币代码，ISO 4217，例如 MXN
voucherType	Y	string	发票类型：I=收入, E=支出, T=转移, N=工资单
issuePlace	Y	string	开票地点邮政编码（总部或分店地址）
email	N	string	客户邮箱，仅内部使用
branchKey	Y	string	分店或门店代码（内部标识）
items	Y	array	商品/服务明细列表

items(Conceptos)字段说明

PayCools对外字段名	必填	类型	说明
productServiceKey	Y	string	商品/服务代码（SAT 产品与服务目录）
itemID	N	string	SKU/条码/产品编号（商户自有编码）
quantity	Y	number	商品/服务数量
unitKey	Y	string	单位代码（SAT 单位目录），如 H87=件
unitName	N	string	单位名称（内部显示用）
description	Y	string	商品/服务描述
unitPrice	Y	number	单价（不含税）
amount	Y	number	金额（= 数量 × 单价）
discount	N	string	折扣
taxes	N	array	税费明细（转移/预扣）

taxes（Impuestos）税明细字段

PayCools对外字段名	必填	类型	说明
taxType	N	string	税种类型：T=转移税, R=预扣税
taxBase	Y	number	税基金额。通常等于对应 Concepto 的 Importe
taxCode	Y	string	税种代码，002=IVA
rateType	Y	string	费率类型：Tasa=税率, Cuota=定额, Exento=免税
rate	Y	number	税率，例如 0.160000=16%
taxAmount	Y	number	税额 = Base × Tasa

Ticket示例：

{
    "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
                }
            ]
        }
    ]
}

base64编码后的Ticket示例：

ewogICAgIm1jaFJyZWNlaXB0SWQiOiAiOTg3NjMwIiwKICAgICJudW1iZXJSZWZlcmVuY2UiOiAiMjAyNTEwMTMxNTYxMjM0MDk4NzExMTEwMDMwIiwKICAgICJpc3N1ZURhdGVUaW1lIjogIjIwMjUtMDktMjIgMDA6MDE6MDguMDAiLAogICAgInRvdGFsQW1vdW50IjogMjY0Ljk5LAogICAgInBheW1lbnRGb3JtIjogIjAxIiwKICAgICJwYXltZW50TWV0aG9kIjogIlBVRSIsCiAgICAiY3VycmVuY3kiOiAiTVhOIiwKICAgICJ2b3VjaGVyVHlwZSI6ICJJIiwKICAgICJpc3N1ZVBsYWNlIjogIjc3NTAzIiwKICAgICJlbWFpbCI6ICJoYXhpbGFtYUBlamVtcGxvLmNvbSIsCiAgICAiYnJhbmNoS2V5IjogIjEwIiwKICAgICJpdGVtcyI6IFsKICAgICAgICB7CiAgICAgICAgICAgICJwcm9kdWN0U2VydmljZUtleSI6ICI5MDEwMTUwMCIsCiAgICAgICAgICAgICJpdGVtSUQiOiAiMjAyNTEwMTMxNTYxMjM0MDk4NzExMTEwMDAxIiwKICAgICAgICAgICAgInF1YW50aXR5IjogIjEiLAogICAgICAgICAgICAidW5pdEtleSI6ICJFNDgiLAogICAgICAgICAgICAidW5pdE5hbWUiOiAiVW5pZGFkZGVTZXJ2aWNpbyIsCiAgICAgICAgICAgICJkZXNjcmlwdGlvbiI6ICJ4eHhoYXhpbG1hd3VodXd1aHV3dWh1OjEyMzQ1Njc4RmVjaGFkZUNvbnN1bW8yMDI0LTExLTI1MDE6MDI6MDguMDAwIiwKICAgICAgICAgICAgInVuaXRQcmljZSI6IDIyOC40NCwKICAgICAgICAgICAgImFtb3VudCI6IDIyOC40NCwKICAgICAgICAgICAgImRpc2NvdW50IjogMC4wLAogICAgICAgICAgICAidGF4ZXMiOiBbCiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgInRheFR5cGUiOiAiVCIsCiAgICAgICAgICAgICAgICAgICAgInRheEJhc2UiOiAyMjguNDQsCiAgICAgICAgICAgICAgICAgICAgInRheENvZGUiOiAiMDAyIiwKICAgICAgICAgICAgICAgICAgICAicmF0ZVR5cGUiOiAiVGFzYSIsCiAgICAgICAgICAgICAgICAgICAgInJhdGUiOiAwLjE2LAogICAgICAgICAgICAgICAgICAgICJ0YXhBbW91bnQiOiAzNi41NQogICAgICAgICAgICAgICAgfQogICAgICAgICAgICBdCiAgICAgICAgfQogICAgXQp9

税票

Ticket Json格式字段说明#

主表字段说明#

items(Conceptos)字段说明#

taxes（Impuestos）税明细字段#

Ticket Json格式字段说明

主表字段说明

items(Conceptos)字段说明

taxes（Impuestos）税明细字段