EN
See the demo

Checkbox + Krokul CRM

Yes. Krokul CRM integrates with Checkbox. Krokul creates a fiscal receipt in the Checkbox software cash register (PRRO) as soon as a deal payment is marked as received. Items and amounts come from the invoice, and the buyer gets the receipt by email or SMS. The fiscal number and the PDF come back to Krokul through a Checkbox webhook and land on the payment.

  • Via API and webhooksYou connect it with the Krokul app in an automation platform, the public API and signed webhooks. The page lists the steps for this service.

What your team gets

A received payment becomes a receipt at once

The accountant marks a deal payment as received, and Krokul calls POST /api/v1/receipts/sell. The goods field gets the names, prices and quantities from the invoice, payments gets the amount and payment type, and order_id gets the Krokul document number. If the cashier shift is closed, Krokul opens it before the first receipt of the day.

The buyer gets the receipt by email

The delivery block of the request takes the email from the deal contact. For clients who left only a phone number, Krokul sends the receipt with the /receipts/{id}/sms method. The manager forwards nothing by hand and sees in the deal feed where the receipt went.

The fiscal number on the payment

After fiscalization, Checkbox sends a webhook to the Krokul connection address. Krokul checks the x-request-signature header, finds the deal by order_id and writes the fiscal number to the payment. A link to the receipt PDF from /receipts/{id}/pdf appears in the deal files.

A refund with a return receipt

When a payment refund is made in Krokul, a return receipt is created with the same receipts/sell method and the is_return flag on the items. Both receipts are visible on the same deal.

The cash register log next to sales

The Checkbox webhook also reports shift openings and closings and service cash deposits and withdrawals. Krokul puts these events into the connection log and closes the shift on the schedule you set.

What moves between Checkbox and Krokul

CheckboxDirectionKrokulWhen
Sale receipt (receipts/sell): goods, payments, order_idKrokul → CheckboxPayment and invoice linesThe payment is marked as received
Receipt delivery (delivery, /email, /sms)Krokul → CheckboxEmail or phone of the deal contactIn the receipt request
Cashier shift (shifts, shifts/close)Krokul → CheckboxConnection settingsBefore the first receipt and on the closing schedule
Receipt fiscalization webhookCheckbox → KrokulFiscal number on the payment, entry in the deal feedAfter fiscalization
Receipt PDF (/receipts/{id}/pdf)Checkbox → KrokulDeal fileAfter fiscalization
Return receipt (goods with is_return)Krokul → CheckboxPayment refundWhen a refund is made
Webhook on shift opening and closing, deposits and withdrawalsCheckbox → KrokulConnection logWhile the cash register works

How to connect today

Your own flow through the Krokul API and webhooks

  1. On my.checkbox.ua, set up a point of sale, a cash register and a cashier, get the cash register license key and prepare the receipt signing key (a QES key file or the cloud DepositSign).
  2. In Krokul, issue an API key with scopes for payments and documents, and subscribe your address to the payment.received event through webhook/api-upsert. Check the x-crm-signature header of every delivery against your secret.
  3. On the event, sign the cashier in with /cashier/signin, open a shift if needed and call /receipts/sell with the invoice lines that document/api-read returns.
  4. Register your address for Checkbox webhooks (POST /api/v1/webhook). Write the fiscal number from the webhook to the deal feed with activity/api-create, and link the receipt id to the payment with externalRef/api-set.

Questions and answers

Does Krokul have a Checkbox integration?

Yes. Krokul integrates with Checkbox through its API and webhooks. Krokul issues a receipt in Checkbox for a received payment, sends it to the buyer and keeps the fiscal number and the receipt PDF on the deal.

What do I need to connect Checkbox?

A cash register in the Checkbox account with a license key, a cashier with a login and password, and a signing key (a QES key file or the cloud DepositSign).

Does every payment in Krokul become a receipt?

No, only the ones that match your rules. In the connection settings, you choose the payment forms and document types that are fiscalized.

How does Krokul know that a receipt is fiscalized?

Checkbox sends a webhook to the Krokul connection address. Krokul checks the x-request-signature header and writes the fiscal number to the payment.

Limits

A Checkbox receipt is signed with the cash register key (a QES key file or the cloud DepositSign), and it is issued on behalf of a cashier with an open shift. Your accountant checks that the receipt contents follow tax rules (VAT rates of items, payment form) in the cash register and item settings.

Missing something?

Tell us which service you use and what should move between it and Krokul. We reply with the way to do it and when it will be ready.

Request received. We reply to your email.

Checkbox is a trademark of its owner. Krokul is not affiliated with Checkbox.

See the demo