docs(specs): record eparagony.pl API access + sandbox verification (#1907) - #2008
Closed
norbert-kulus-blockydevs wants to merge 2 commits into
Closed
docs(specs): record eparagony.pl API access + sandbox verification (#1907)#2008norbert-kulus-blockydevs wants to merge 2 commits into
norbert-kulus-blockydevs wants to merge 2 commits into
Conversation
…1907) Registration completed and the sandbox verified by read-only calls (OAuth, an authenticated printer-status read, scope enforcement, and an unauthenticated-401 control). Production was deliberately not touched. Records in spec 1902: - new §3 subsection with the verified probes, the granted vs refused scopes, the fact that the sandbox has no attached fiscal device (so it cannot exercise device -> eDPS -> repository -> webhook), and two documentation/reality drifts the adapter must tolerate; - supersedes the stale "docs and sandbox gated behind registration" bullet; - R3 marked STILL OPEN — a sandbox is issued to Custom-API customers too, so technical access does not establish the pricing class; - three decision-log rows and a partial-progress note in §9. Refs #1907 Signed-off-by: norbert-kulus-blockydevs <norbert.kulus@blockydevs.com>
… breakdown Two documentation artefacts had no owning issue: the ADR the new fiscalisation capability port mandates, and the standard per-integration docs set. Both now exist and are wired into spec 1902: - #2009 (ADR + implementation plan) added above #1908 as a pre-code input; - #2010 (integration docs set) added after #1911, with its manual-testing chapter flagged as gated on a sandbox fiscal device; - sequencing line updated for both; - records that the gitignored vendor mirror stays gitignored (the vendor's robots.txt is Disallow: /), so it is not committed by a later contributor. Refs #1907, #2009, #2010 Signed-off-by: norbert-kulus-blockydevs <norbert.kulus@blockydevs.com>
Collaborator
Author
|
Closing as superseded. This PR exists to unblock #1907 (secure eparagony.pl integrator-class pricing + sandbox access before building). #1907 is now closed — it got unblocked by finding eparagony.pl's public OpenAPI 3.0 contract instead, which let #1908/#2137 build and verify the adapter directly against the sandbox without waiting on the vendor conversation this PR was tracking. The live sandbox verification is now recorded in #2137's E2E evidence instead. No code or schema here, so nothing is lost by closing. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Records the outcome of the eparagony.pl vendor registration and the sandbox verification into the #1902 product spec. Documentation-only — no code, no schema, no runtime change.
What happened
Registration completed, credentials issued, and the sandbox verified by direct read-only calls. Nothing was created or mutated, and production was deliberately left untouched (a probe against
login.eparagony.plreturns401 invalid_client— the credentials are sandbox-scoped, as expected).POST login.sandbox.eparagony.pl/auth/token(client_credentials)200— bearer token,expires_in: 3600GET sandbox.eparagony.pl/printers/{num}/status200—{"status":"INACTIVE",…}401 Access denied— authorization enforcedGET /documents/{random-uuid}/status400 errorCode: 92— token accepted, document absentGET /printers/{num}/reports/dailywithoutreport_fiscal_get403 Forbidden— scope enforcement confirmedWhat the spec now says
document_create,printer_get,ecommerce) versus those refused at token issuance (document_get_jws,report_fiscal_get), the fact that the sandbox has no attached fiscal device — so it exercises the API contract but not device → eDPS → repository → webhook — and two documentation/reality drifts the adapter must tolerate (X-Api-Version/X-Integration-Idunenforced on GETs; an undocumentederrorCode: 92).X-Integration-IdOL received is a supporting signal, not a classification.What is still outstanding on #1907
Only the technical-access acceptance criterion is met. Still open, and all non-engineering:
#1907 therefore stays open. Per the §9 sequencing #1908's design still runs in parallel, but the build-owner question should be pressed before #1908 moves from design into build.
How to review
Read the diff of
docs/specs/product-spec-1902-eparagony-e-receipts.md. The probes are reproducible against the sandbox with the credentials held out-of-band; the mirrored vendor spec atdocs/vendor/eparagony/is gitignored and unchanged by this PR.Refs #1907
🤖 Generated with Claude Code