Skip to content

docs(readme): explain how to save document items and debug requests - #56

Merged
pekral merged 1 commit into
masterfrom
docs/document-items
Nov 12, 2026
Merged

pekral merged 1 commit into
masterfrom
docs/document-items

Conversation

@pekral

@pekral pekral commented Nov 12, 2026

Copy link
Copy Markdown
Collaborator

Closes #38

TL;DR

Issue #38 nehlásí chybu klienta. FlexiBee nepovoluje importovat položky dokladu napřímo. README teď ukazuje správný postup a co se dá zjistit o odeslaném requestu.

Rozbor

V issue se položky faktury ukládaly jako samostatná evidence faktura-vydana/{id}/polozkyDokladu. Dokumentace FlexiBee říká, že položky dokladů mají importStatus NOT_DIRECT: přímo importovat nejdou, jen přes nadřazený záznam, a pokus o přímý import skončí hláškou „Import není povolen.“ (Import evidencí přes API). Klient tu hlášku jen předává ve výjimce.

Změny (jen README)

  • Nová sekce Položky dokladu:
    • ukládání položek vnořených v dokladu přes save(),
    • přepínač polozkyDokladu@removeAll (Výmaz zanořené evidence),
    • upozornění, že špatný název kolekce FlexiBee tiše ignoruje.
  • Nová sekce Ladění požadavků: co ukáže $debugMode a výjimky (druhý dotaz z issue, jak zjistit odeslaný request).
  • Názvy polí položek dokumentace neuvádí, proto README odkazuje na getPropertiesForEvidence().

Merge danger

  • Dveře: two-way, jen dokumentace.

Testování

  • composer check prochází (beze změny kódu). Nové testy: ne.

Document items cannot be imported directly: FlexiBee answers a direct
import into faktura-vydana/{id}/polozkyDokladu with "Import není
povolen" (importStatus NOT_DIRECT). The README now shows saving items
nested in the parent document, the polozkyDokladu@removeAll switch and
what the debug mode and exceptions reveal about a failed request.

Closes #38
@pekral pekral added this to the 2.0.0 milestone Nov 12, 2026
@pekral
pekral marked this pull request as ready for review November 12, 2026 15:04
@pekral

pekral commented Nov 12, 2026

Copy link
Copy Markdown
Collaborator Author

Code Review

Status: clean
Counts: Critical 0 · Moderate 0 · Minor 0 · Refactoring 0
Last updated: 2026-11-12T15:05:05Z (head 0e789a1)
Issue tracker summary: no linked issue summary posted — #38 is the source issue (support question)


Summary: 0 Critical · 0 Moderate · 0 Minor · 0 Refactoring · assignment conformance: conformant (#38: explains the "Import není povolen" cause with the FlexiBee docs and how to inspect a failed request) · reviewer comments: none

@pekral
pekral merged commit c8dac5e into master Nov 12, 2026
4 checks passed
@pekral
pekral deleted the docs/document-items branch November 12, 2026 15:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

EcomailFlexibeeRequestError - Import not allowed

1 participant