====== SSapIDOCSender ======

===== Popis =====

Webová služba pro odesílání IDoc zpráv (XML) z OR-SYSTEM Open do SAP systému. Jednotlivé agendy vygenerují XML soubor podle příslušného IDoc typu a odešlou ho přes společnou třídu ''SSapIDOCSender'' (metoda ''send(SSapIDOCSenderIO)'', parametr ''xmlPath'' – cesta k vygenerovanému XML souboru).

===== Odesílané typy zpráv =====

==== FIDCCP – zaúčtování vydané faktury ====

Generuje třída ''SFakturaVydanaZauctovaniSapFidccp'' (IDoc typ ''FIDCCP02'', ''MESTYP=FIDCC2'').

  * Sestaví hlavičku ''EDI_DC40'' a účetní hlavičku ''E1FIKPF'' (datum, měna, kurz, číslo dokladu).
  * Naplní segmenty ''E1FISEG'' – odběratelský segment, jednotlivé účetní položky (dle ''CUcetniZadostRadek''), případně segment odúčtování zálohy.
  * Rozlišuje typ dokladu (''BLART''): ''DR'' běžná faktura, ''DX'' záloha, ''DG'' dobropis.
  * Umožňuje úpravu jednotlivých segmentů (DC40, E1FIKPF, E1FISEG) přepínatelnými makry (''LO_SFakturaVydanaZauctovaniSapFidccp_Makro_*'').
  * Výsledek odeslání (status/odpověď) se zapisuje zpět do ''CUcetniZadost'' (příznak ''Prev'' a text odpovědi).

==== DEBMAS – export odběratele ====

Generuje třída ''SOdberatelSapDebmas'' (IDoc typ ''DEBMAS07'', ''MESTYP=DEBMAS'').

  * Naplní hlavičku odběratele (''E1KNA1M'') – adresa, IČO, DIČ, jazyk.
  * Naplní účetní data (''E1KNB1M'') – účet, způsob platby (tuzemský/zahraniční partner).
  * Naplní bankovní spojení (''E1KNBKM'') – pro každý záznam z ''O6a1''.
  * Lze upravovat makry (''LO_SOdberatelSapDebmas_Makro_*'').
  * Spouští se buď přímo (jeden odběratel), nebo dávkově přes cron ''SOdberatelSapDebmasCron'' (parametr ''provedExport'', volitelně počet dní zpětně nebo ''X'' pro všechny).

==== CREMAS – export dodavatele ====

Generuje třída ''SDodavatelSapCremas'' (IDoc typ ''CREMAS07'', ''MESTYP=CREMAS''). Strukturálně analogické k DEBMAS – ''E1LFA1M'' (hlavička dodavatele), ''E1LFB1M'' (účetní data), ''E1LFBKM'' (bankovní spojení). Dávkově přes cron ''SDodavatelSapCremasCron''.

===== Společný princip generování =====

Všechny tři agendy sdílí stejný vzor:
  - Naplnění JAXB modelu (hlavička ''EDI_DC40'' + specifická data).
  - Volitelná úprava jednotlivých segmentů přes systém maker (přepínače ''LO_<Agenda>_Makro_*'').
  - Serializace do XML souboru (JAXB Marshaller, UTF-8, formátovaný výstup) do adresáře dle přepínače ''LO_<Agenda>_PathOut'' (v názvu souboru lze použít zástupné znaky ''#NR'' – číslo dokladu/partnera, ''#DT'' – datum a čas).
  - Odeslání souboru přes ''SSapIDOCSender.send()''.

===== Swagger / OpenAPI =====

**URL Swagger UI:** <URL_SWAGGER_UI>
**URL OpenAPI JSON:** <URL_OPENAPI_JSON>

===== Poznámky =====

  * Opačný směr (příjem IDoc zpráv ze SAP, např. ZUHRADA – potvrzení úhrady) zajišťuje [[orfertopen:lc:lc_api:ssap_idoc_receiver|SSapIDOCReceiver]].
  * Dávkové (cron) spouštění exportů DEBMAS/CREMAS je řízeno přes ''OBatchService''/''O0taskDemonUtil'' standardním mechanismem OR-SYSTEM úloh, ne přímo přes webové rozhraní.