🪪 Diia — what is not there, and why it is separate
Updated
How not to mix Diia with M.E.Doc and PrivatBank on a project. The tax invoice — M.E.Doc at a customer. The statement — PrivatBank.
This is not a "where to click" page: the delivery has neither Diia login nor Diia document signing. The page fixes the boundary so an implementation does not wait for the wrong sandbox and does not put a Diia token on the tax or bank card.
Two contours, not one connector#
| Contour | Whose layer | What it does | Today |
|---|---|---|---|
| Sign-in to ZuloOne via Diia.ID | platform identity, not a country package | who this user is | no |
| Signing / sharing a document via Diia.Підпис | not in the package | there is no outbound Diia channel | no |
Mixing them onto one TaxAuthorityConnection card puts the accountant's login
where MakeDoc goes. Mixing them with UaBankConnection puts a bank token and
a Diia secret in one dictionary. Neither dictionary exists for that.
Diia login is not a country-package object. Sign-in is platform identity. There is no Diia.ID connector in the product.
There is no Diia signing channel in the package. Do not wait for one before
seating M.E.Doc and PrivatBank. Those channels sit
on IOutboundGateway; Diia does not.
What's not there yet#
There is no partner API in the delivery. There is nothing to put in a
channel baseUrl. A made-up URL is not a Diia connector.
Diia's public showcases (document sharing, Diia.Підпис for a natural person in
the app) are a different product and a different application, not "almost a
tax invoice". Pasting them into erpn-send breaks MakeDoc.
There is no cloud sandbox "for an ERP, like gw-fatoora" under our tax invoice.
Waiting for sandbox.diia.gov.ua instead of a M.E.Doc agent is pointless: the
invoice goes to ЄРПН through M.E.Doc, not through Diia.
The ДПС cabinet is neither Diia nor M.E.Doc REST. It is not in the package.
What not to set up#
Fill in nothing under the name Diia. Do not create a channel, do not write
a URL, do not put a client secret in Integration:Credentials under the name
diia. An empty card is more honest than a fake address.
Do not put Diia on TaxAuthorityConnection or UaBankConnection.
How not to check "maybe it is already there"#
There is no "send to Diia" button on the invoice. A ПДВ-payer invoice goes to
M.E.Doc on channel erpn-send. The statement is the PullUaBankStatements
job. Neither calls Diia.
There are no UkraineDiia* tests in the package — not a coverage hole, there
is nothing to cover.
There is no Diia outbound channel in the package: nowhere to dial, nothing to sign with. Seat M.E.Doc and PrivatBank without waiting on Diia.
Same topic for other readers: User · Developer