Obsah
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_DC40a účetní hlavičkuE1FIKPF(datum, měna, kurz, číslo dokladu). - Naplní segmenty
E1FISEG– odběratelský segment, jednotlivé účetní položky (dleCUcetniZadostRadek), případně segment odúčtování zálohy. - Rozlišuje typ dokladu (
BLART):DRběžná faktura,DXzáloha,DGdobropis. - 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říznakPreva 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 zO6a1. - Lze upravovat makry (
LO_SOdberatelSapDebmas_Makro_*). - Spouští se buď přímo (jeden odběratel), nebo dávkově přes cron
SOdberatelSapDebmasCron(parametrprovedExport, volitelně počet dní zpětně neboXpro 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 SSapIDOCReceiver.
- Dávkové (cron) spouštění exportů DEBMAS/CREMAS je řízeno přes
OBatchService/O0taskDemonUtilstandardním mechanismem OR-SYSTEM úloh, ne přímo přes webové rozhraní.