_54fz-data_en.html.md

Electronic Receipt Transfer (by Fed.Rule 54) {#cheque}

To work on 54-FZ Rule, the Payment Protocol provides a tool to interact with your online cash register. Information to form a fiscal receipt is passed on to the JSON-object cheque of invoice, payment, and refund API methods.

Fiscal receipt generation is available for Bank card payment method only.

To activate the fiscal receipt service, contact your manager in QIWI Support with the TIN number with which your organization is registered in the online cash rental service.

For the ATOL service, provide the following data also:

• RSP's email for receipt printing
• Full title of the organization
• Fiscal data operator details (name, TIN, URL)
• Login / password for security token generation
• Commodity group code

Fiscal receipt for the successful operation is provided in chequeData object in the synchronous response to the operation, and in the operation notification.

JSON-object description {#cheque-model}

{
 ...
 "cheque" : {
  "sellerId" : 3123011520,
  "customerContact" : "Test customer contact",
  "chequeType" : "COLLECT",
  "taxSystem" : "OSN",
  "positions" : [
    {
      "quantity" : 1,
      "price" : {
        "value" : 7.82,
        "currency" : "RUB"
      },
      "tax" : "NDS_0",
      "paymentSubject" : "PAYMENT",
      "paymentMethod" : "FULL_PAYMENT",
      "description" : "Test description"
    }
  ]
 }
}

Parameter	Req.	Type	Description
sellerId	Y	Number	Organization's TIN
chequeType	Y	String	Cash operation (1054 fiscal tag): COLLECT – Incoming cash COLLECT_RETURN - Cash return CONSUME - Outgoing cash CONSUME_RETURN - Outgoing cash return
customerContact	Y	String(64)	Customer's phone or e-mail (fiscal tag 1008)
taxSystem	Y	String	Tax system (fiscal tag 1055): OSN - General USN – Simplified income USN_MINUS_CONSUM – Simplified income minus expense ENVD – United tax to conditional income ESN - United agriculture tax PATENT – Patent tax system
positions	Y	Array	Commodities list
--------	-------	----------	--------
quantity	Y	Number	Quantity (fiscal tag 1023)
price	Y	Number	One item price, with discounts and extra charges (fiscal tag 1079)
tax	Y	String	VAT rate (fiscal tag 1199): NDS_CALC_18_118 - VAT rate 18% (18/118) NDS_CALC_10_110 – VAT rate 10% (10/110) NDS_0 – VAT rate 0% NO_NDS – VAT not applicable NDS_CALC_20_120 – VAT rate 20% (20/120) (20/120)
description	Y	String(128)	Name
paymentMethod	Y	String	Cash type (fiscal tag 1214): ADVANCED_FULL_PAYMENT – payment in advance 100%. Full payment in advance before commodity provision PARTIAL_ADVANCE_PAYMENT – payment in advance. Partial payment before commodity provision ADVANCE – prepayment FULL_PAYMENT – full payment, taking into account prepayment, with commodity provision PARTIAL_PAYMENT – partial payment and credit payment. Partial payment for the commodity at the moment of delivery, with future credit payment. CREDIT – credit payment. Commodity is delivered with no payment at the moment and future credit payment is expected. CREDIT_PAYMENT – payment for the credit. Commodity payment after its delivery with future credit payment.
paymentSubject	Y	String	Payment subject (fiscal tag 1212): COMMODITY – commodity except excise commodities (name and other properties describing the commodity). EXCISE_COMMODITY – excise commodity (name and other properties describing the commodity). WORK – work (name and other properties describing the work). . SERVICE – service (name and other properties describing the service). GAMBLING_RATE – gambling rate (in any gambling activities). GAMBLING_PRIZE – gambling prize payment (in any gambling activities). LOTTERY_TICKET – lottery ticket payment (in accepting payments for lottery tickets, including electronic ones, lottery stakes in any lottery activities). LOTTERY_PRIZE – lottery prize payment (n any lottery activities). GRANTING_RESULTS_OF_INTELLECTUAL_ACTIVITY – provision of rights to use intellectual activity results. PAYMENT – payment (advance, pre-payment, deposit, partial payment, credit, fine, bonus, reward, or any similar payment subject). AGENCY_FEE – agent's commission (in any fee to payment agent, bank payment agent, commissioner or other agent service). COMPAUND_PAYMENT_SUBJECT – multiple payment subject (in any payment constituent subject to any of the above). OTHER_PAYMENT_SUBJECT – other payment subject not related to any of the above.