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:

  1. Naplnění JAXB modelu (hlavička EDI_DC40 + specifická data).
  2. Volitelná úprava jednotlivých segmentů přes systém maker (přepínače LO_<Agenda>_Makro_*).
  3. 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).
  4. 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 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í.