¶ Obecný popis integrace
Předpoklady:
- V Pohodě je evidované jak nakupované, tak vyráběné zboží.
- Nakupovaným zbožím (materiálem) rozumíme zboží bez výrobního postupu, které ani výrobní postup nikdy nemělo. Vyráběné zboží je zboží s výrobním postupem.
- Zboží u kterého není v době naskladnění ve Factorify známá správná cena (není zadaná faktura, spotřebovaný materiál není oceněný, ...) bude tzv. blokované. Doklady, které obsahují takové zboží nebudou exportované do Pohody. Zároveň, pozdější doklady, které mají společné zboží se zablokovaným dokladem budou také zablokované rekurzivně. Přehled blokovaného zboží je dostupný v agendě Nastavení -> Blokované zboží.
- Pokud synchronizace s Pohodou selže, vytvoří se hlášení typu "Chyby v synchronizaci s Pohodou", obsahující detailní popis problému.
¶ Export fakturační adresy
Fakturační adresa se do Pohody vyexportuje v okamžiku uložení změn.
Existující adresu v Pohodě je možné s adresou ve Factorify spárovat pomocí:
- Externího ID adresy ve Factorify, respektive čísla (obchodní údaje) v Pohodě.
- IČ nebo DIČ
Pokud je adresa v Pohodě vytvořená, nedojde ke spárování s jinou adresou, aby nedošlo k vytvoření duplicitní adresy.
| Factorify | Pohoda |
|---|---|
| Externí ID adresy | Číslo |
| Název z adresy nebo společnosti | Firma |
| 1. řádek adresy | Ulice |
| Město | Obec |
| PSČ | PSČ |
| Země | Kraj |
| IČ | IČ |
| DIČ | DIČ |
| Členění DPH | Členění DPH |
| První služební email společnosti nebo první email | |
| První služební telefon společnosti nebo první telefon | Telefon |
¶ Import fakturační adresy
Fakturační adresa / společnost se z Pohody importuje v okamžiku importu přijatých objednávek a to pouze v případě, že adresa se stejným číslem (externí ID) ve Factorify již neexistuje.
Společnost
| Pohoda | Factorify |
|---|---|
| Název | Název |
Adresa
| Pohoda | Factorify |
|---|---|
| Číslo | Externí ID adresy |
| Firma | Název, pokud se liší od názvu společnosti |
| Ulice | 1. řádek adresy |
| Obec | Město |
| PSČ | PSČ |
| Kraj | Země |
| IČ | IČ |
| DIČ | DIČ |
Kontakt (email)
| Pohoda | Factorify |
|---|---|
| Hodnota |
Kontakt (telefon)
| Pohoda | Factorify |
|---|---|
| Telefon | Hodnota |
¶ Import dodací adresy
Dodací adresa se z Pohody importuje v okamžiku přijatých objednávek. Importují se pouze ty dodací adresy na přijatých objednávkách v případě, že ve Factorify neexistuje adresa (jakákoli) se stejným 1. řádkem adresy, městem a PSČ.
| Pohoda | Factorify |
|---|---|
| Firma | Název, pokud se liší od názvu společnosti |
| Ulice | 1. řádek adresy |
| Obec | Město |
| PSČ | PSČ |
| Kraj | Země |
¶ Export zboží
Zboží se do Pohody vyexportuje v okamžiku uložení změn.
Existující zboží v Pohodě je možné se zbožím ve Factorify spárovat pomocí:
- Externího ID ve Factorify, respektive kódu zásoby v Pohodě. Pokud není externí ID vyplněné, vygeneruje se ve formátu MT-<id zboží ve factorify>
| Factorify | Pohoda |
|---|---|
| Externí ID nebo MT-[ID] | Kód |
| Zboží má / nemá workflow nebo je neskladové | Karta, výrobek, služba |
| Klasifikace typu zboží | Zaúčtování - druh (účtování metodou A) |
| Kód + název | Název |
| Nějaký čárový kód | Čár. kód |
| Jednotka | M.j. |
¶ Import zboží
Zboží se z Pohody importuje v okamžiku importu přijatých objednávek a to pouze v případě, že zboží se stejným kódem (externí ID) ve Factorify již neexistuje.
| Pohoda | Factorify |
|---|---|
| Kód | Externí ID |
| Je služba | Je neskladové zboží |
| Kód | Kód |
| Název | Název |
| M.j. | Jednotka |
¶ Příjemka skladové objednávky
Skladová příjemka ke skladové objednávce se do Pohody vyexportuje v okamžiku splnění následujících podmínek.
- Položky skladové objednávky jsou ve stavu "ukončeno".
- Skladová příjemka neobsahuje blokované zboží.
Hlavička
| Factorify | Pohoda |
|---|---|
| Datum prvního pohybu | Datum |
| První fakturační adresa dodavatele | Dodavatel |
| Měna objednávky | Měna |
Položka
| Factorify | Pohoda |
|---|---|
| Zboží | Kód a položka |
| Sklad | Kód a položka |
| Nákladové středisko skladu nebo skupiny skladů | Středisko |
| Množství | Množství |
| Jednotka zboží | M.j. |
| Cena položky objednávky + Dodatečné náklady v měně objednávky | Jedn. cena |
| Měna objednávky | Měna |
Dodatečné náklady v jiných měnách
| Factorify | Pohoda |
|---|---|
| Popis nákladu | Text |
| Vždy 1 | Množství |
| Vždy ks | M.j. |
| Suma dodatečných nákladů v měně | Cena |
| Měna dodatečných nákladů | Měna |
¶ Příjem vyráběného zboží z kooperace
Kooperační objednávka se do Pohody vyexportuje jako skladová příjemka, bez vazby na skladové položky. A to v okamžiku splnění následujících podmínek. Export se spouští každých 15 minut.
- K položce kooperační objednávky existuje alespoň jeden nevyexportovaný záznam práce (příjmu z kooperace).
- Pokud je nastavený globální parametr "Blokovat export nedokončených kooperačních objednávek", položka kooperační objednávky je ve stavu ukončeno.
- Uplynula alespoň jedna hodina od posledního příjmu pro kooperační objednávku.
Hlavička
| Factorify | Pohoda |
|---|---|
| Poslední datum doručení (záznam práce) z položky | Datum |
| Měna kooperační objednávky | Měna |
| První fakturační adresa kooperanta | Dodavatel |
Položka
| Factorify | Pohoda |
|---|---|
| ID položky + zboží | Položka |
| Množství | Nevyexportované množství záznamů příjmu z kooperace |
| Jednotka zboží | M.j. |
| Cena | Jedn.cena |
| Měna | Měna |
¶ Příjem z výroby
Vyráběné zboží se vyexportuje v okamžiku splnění následujících podmínek.
- Je povolený export vyráběného zboží.
- Není nastavená globální parametr export vyráběného zboží bude blokovaný jiným zbožím nebo skladové příjemky spotřebovaného materiálu a relevantní kooperační objednávky jsou dokončené.
- Od času skladového pohybu uplynula doba nastavená v globálním parametru pozdržet export vyráběného zboží.
Skladové příjemky z výroby se exportují v případě, že neobsahují blokované zboží. Všechny dosud nevyexportované příjmy z výroby se vyexportují na jedné příjemce.
Hlavička
| Factorify | Pohoda |
|---|---|
| Datum prvního pohybu | Datum |
| Vždy CZK | Měna |
Položka je obdobná jako u příjmu z objednávky, kromě
| Factorify | Pohoda |
|---|---|
| Cena z výpočtu nákladů na výrobu zboží. V případě "příjmu z výroby" u nevyráběného zboží se použije jeho VNC nebo cena z poslední ukončené sklad. objednávky. | Jedn. cena |
| Vždy CZK | Měna |
¶ Výdej do výroby
Výdejka do výroby se exportuje v okamžiku splnění následujících podmínek.
- V případě polotovarů je povolený export vyráběného zboží.
- Výdejka neobsahuje blokované zboží.
- Pokud výdejka obsauje vyráběné zboží, počká se na noční přepočítání ohodnocení.
Skladové výdejky do výroby se exportují v případě, že neobsahují blokované zboží. Všechny dosud nevyexportované příjmy z výroby se vyexportují na jedné výdejce.
Položky výdejky do výroby jsou sloučeny podle zboží a skladu. Tedy několik pohybů stejného zboží ve Factorify bude v tomto případě odpovídat jednomu pohybu v Pohodě.
Můžeme vydávat bez ocenění? Pak bysme nemuseli blokovat. Pozor na výdeje do záporu!
Vadí špatné ohodnocení výdeje ze skladu? Pokud ne, nemusíme čekat na noční přepočítání ocenění.
Hlavička
| Factorify | Pohoda |
|---|---|
| Datum posledního pohybu | Datum |
| Vždy CZK | Měna |
Položka
| Factorify | Pohoda |
|---|---|
| Zboží | Kód a položka |
| Sklad | Kód a položka |
| Nákladové středisko skladu nebo skupiny skladů nebo člověka | Středisko |
| Množství | Množství |
| Jednotka zboží | M.j. |
¶ Expedice (prodej)
Dodací list se do Pohody exportuje jako skladová výdejka s cenami z přijaté objednávky, v okamžiku splnění následujících podmínek.
- Dodací list je ve stavu uzavřeno.
- Dodací list neobsahuje blokované zboží.
Bez oprávnění "Dodací listy -> Zrušit nebo upravit dokončený" nelze upravit množství položek dodacího listu, po tom co už byl dodací list uzavřený a vyexportovaný do Pohody. V případě, že uživatel oprávnění má a množství upraví, Factorify v takovém případě nevytvoří opravný doklad a proto je nutné dodací list opravit ručně v Pohodě.
Hlavička
| Factorify | Pohoda |
|---|---|
| Datum posledního pohybu nebo datum vystavení, pokud je pozdější | Datum vystavení |
| Zákaznické číslo objednávky jedné z objednávek | Číslo obj. |
| Poznámka | Poznámka |
| ID + interní poznámka | Interní poznámka |
| Měna z objednávky | Měna |
| První fakturační adresa zákazníka | Odběratel |
| Volný atribut typ platby některé z objednávek | Forma |
Dodací adresa dodacího listu (v případě že se liší od fakturační)
| Factorify | Pohoda |
|---|---|
| Název z adresy nebo společnosti | Firma |
| 1. řádek adresy | Ulice |
| Město | Obec |
| PSČ | Obec |
| Země | Kraj |
Položka objednávky
| Factorify | Pohoda |
|---|---|
| Zboží | Kód a položka |
| Sklad | Kód a položka |
| Kód a název zboží + zákaznické číslo objednávky nebo její položky | Text |
| Jednotka zboží | M.j. |
| Cena | Jedn. cena |
| Měna | Měna |
| Sleva (%) | Sleva % |
Balík dodacího listu
| Factorify | Pohoda |
|---|---|
| Název dopravce | Text |
| Vždy 1 | Množství |
| Vždy ks | M.j. |
| Cena transportu | Cena |
| Měna transportu | Měna |
Balicí materiál dodacího listu
| Factorify | Pohoda |
|---|---|
| Kód a název zboží | Text |
| Množství | Množství |
| Jednotka zboží | M.j. |
| Cena | Jedn. cena |
| Měna | Měna |
¶ Import přijatých objednávek
Pokud je nastavený patřičný parametr v application.properties, pak se jednou za hodinu importují přijaté objednávky. Pokud je objednávka již naimportovaná, dle čísla objednávky (externí ID), pak se znovu již neimportuje.
Společně s importem objednávek se importuje i dosud neexistující zboží a adresy viz relevantní kapitoly.
Objednávka
| Pohoda | Factorify |
|---|---|
| Číslo | Externí ID |
| Datum zápisu | Přijato |
| Odběratel | Zákazník |
| Odběratel -> dodací adresa | Adresa |
| Měna | Měna |
| Text | Poznámka |
| Středisko | Volný atribut nákladové středisko `costCenter` |
| Činnost | Volný atribut činnost `activity` |
Položka objednávky
| Pohoda | Factorify |
|---|---|
| Kód (pouze sklad. zásoba) | Zboží |
| Množství | Množství |
| Jedn. cena (je zohledněno DPH) | Cena |
| Sleva % | Sleva |
| Vyřídit do nebo datum zápisu + 14 dní | Požadované dodání |
| Vyřídit do nebo datum zápisu + 14 dní | Požadovaná expedice |
| Poznámka | Poznámka |
¶ Import vážených nákupních cen
Vážené nákupní ceny se z Pohody importují v pravidelných jednodenních intervalech, po půlnoci. Zároveň se aktualizují v okamžiku exportu dokladu ve kterém je vážená nákupní cena použita pro ocenění položky dokladu.
¶ Report hodnoty rozpracované výroby
Factorify nabízí standardní agendy pro zobrazení hodnoty rozpracované výroby k datu, případně rozpětí datů. Menu "Ekonomika".
¶ Report hodnoty nakupovaného zboží
TODO Report nakupovaného zboží k datu. Řádek reportu odpovídá jedné skladové položce bez ohledu na sklad.
¶ Nastavení
¶ Pohoda
- Globální nastavení -> Sklady -> Pohyby -> Řazení pohybů nastavte na "příjmy, výdeje".
¶ Sklady
- Externí ID skladu musí odpovídat existující zkratce názvu skladu v Pohodě. V členění skladů v Pohodě ověřte, že pro sklad existuje záznam, bez jakékoli větve / vnořené úrovně.
¶ Globální parametry
-
Pozdržet export vyráběného zboží [dny], slouží pro nastavení časové rezervy ve které je možné například doplnit ceny kooperací nebo nakupovaného zboží a díky tomu mohlo dojít ke spočítání správné hodnoty zboží za kterou bude naskladněno z výroby. Hodí se, kdy stále čekáme na fakturu za materiály nebo služby i přesto, že je zboží již fyzicky vyrobené.
-
Blokovat export příjmů z výroby (vzorec), zajistí, že se příjmy z výroby po datu a času určeném vzorcem nevyexportují. Protože se skladové pohyby z a do výroby slučují, vhodným nastavením tohoto parametru lze například zařídit, že se příjmy z výroby vyexportují hromadně, jednou za den. Vzorec lze nastavit:
- Lze určit konkrétní čas, do kdy se mají pohyby blokovat. Například
04:00znamená, že se pohyby blokují do čvtrté hodiny ranní aktuálního dne. - Lze určit dobu, po kterou se mají pohyby blokovat.
14 DAYSznamená, že se blokují pohyby novější, než 14 dní. Jednotku času je nutné uvést anglicky. - Lze zkombinovat dvě předchozí hodnoty.
1 DAY 04:00znamená, že se budou blokovat pohyby do čtvrté hodiny ranní aktuálního dne. - Lze uvést více hodnot oddělených čárkou. Nastavením
04:00, 16:00dojde k exportu dvakrát denně.
- Lze určit konkrétní čas, do kdy se mají pohyby blokovat. Například
-
Blokovat export výdejů z výroby (vzorec), funguje stejně jako u příjmů.
-
Blokovat export vyráběného zboží před přepočítáním ekonomiky, zabrání exportu příjmů vyráběného zboží z výroby, pokud není přepočítaná ekonomika. K jejímu přepočtu dochází jednou denně po půlnoci.
-
Export vyráběného zboží bude blokovaný jiným zbožím zajistí, že se vyráběné zboží nevyexportuje dokud nebude známé jeho ocenění. Tedy, skladové objednávky spotřebovaného materiálu nebo relevantní kooperační objednávky nebudou dokončené.
-
Blokovat export nedokončených skladových objednávek, blokuje položky skladových objednávek, které nejsou ve stavu ukončeno. Pokud je na skladové objednávce 10 položek, všechny jsou přijaté, ale pouze 5 jich má stav ukončeno, pak se 5 neukončených položek nevyexportuje.
Je nutné upozornit na to, že pokud je položka zablokovaná, taková položka může blokovat export dalších skladových pohybů, pokud by to znamenalo, že v případě přeskočení takové položky by v Pohodě způsobilo výdej do záporu nebo chybný výpočet vážené nákupní ceny. Přehled blokovaných položek je dostupný v agende Nastavení -> Blokované zboží
-
Omezit blokování exportu zboží [měsíce], i přesto, že není položka skladové objednávky ve stavu ukončeno, vyexportuje se, pokud byla přijata na sklad před delší dobou, než je nastaveno v tomto parametru. Slouží jako ochrana proti "zapomenutým" položkám.
-
Importovat objednávky od, zvoleného data. Je možné nastavit na starší datum v případě, že chcete importovat starší objednávky. Při každém importu se automaciky nastaví na včerejšek.
-
Povinná cena skladových objednávek, neumožní přepnout položku skladové objednávky do stavu ukončeno a tím ji vyexportovat do Pohody, pokud nemá nenulovou cenu.
¶ Konfigurace application.properties
Před spuštěním exportu je v konfiguračním souboru Factorify (application-*.properties) nutné nastavit výchozí adresu Pohoda-connectoru a členění skladů.
pohoda.api.url=http://***
pohoda.api.username=***
pohoda.api.password=***
# Identifikátor skladu v Pohodě, pro sklady bez vyplněného externího ID
pohoda.default-stock-external-id=OSTATNI
# Odkomentovat v případě exportu vyráběného zboží
# pohoda.export-products=true
# Odkomentovat v případě importu přijatých objednávek
# pohoda.import-orders=true
# Odkomentovat, pokud chcete měnit externí ID zboží
# pohoda.allow-goods-extid-change=true
Názvy obsahující diakritiku je nejdříve nutné převést do ASCII formátu, pomocí native2ascii.
¶ Pohoda connector
Connector je Java microservice, spouštějící import do Pohody (potřebuje mít přístup k pohoda.exe) a umožňující vyčítání stavů skladů a vážench nákupních cen z Pohody (potřebuje přístup k souboru nebo serveru s databází účetní jednotky Pohody). Connector vystavuje REST endpointy zabezpečené HTTP basic access authentication.
¶ Předpoklady pro provoz
- Systém má dostupných alespoň 2 GB RAM.
- Nainstalovaná Java 8 64 bit.
- Aplikace má přístup k Pohoda.exe
- Aplikace má přístup k databázi účetní jednotky, ať už v MS Access souboru nebo SQL Serveru.
¶ Instalace
-
Do libovolné instalační složky nakopírujte soubory aplikace
pohoda-connector-0.0.1-SNAPSHOT.jar,logrotate-1.0-SNAPSHOT.jarapohoda-connector.cmd.Soubory jsou dostupné v repozitáři https://bitbucket.org/factorify/pohoda-connector/src/master/bin/
-
Vedle souborů aplikace vytvořte konfigurační soubor
application-production.propertiesa vyplňte následující hodnoty.Autentikační údaje pro HTTP basic authentication.
api.username=pohoda-username api.password=pohoda-passwordPřístup k Pohoda.exe a uživatel pro spuštění importu
pohoda.exe-path=C:\\Program Files (x86)\\STORMWARE\\POHODA\\pohoda.exe pohoda.my-state-ident-no=12345678 pohoda.database=12345678_2020.mdb pohoda.username=*** pohoda.password=***V případě MS Access databáze
pohoda.access.file-path=C:\\Pohoda\\Data\\12345678_2020.mdb # Seznam databází, oddělených čárkou, z minulých účetních období, pro načítání vážených nákupních cen v minulosti. pohoda.access.previous-accounting-period-file-names=12345678_2019.mdb,12345678_2018.mdbV případě připojení na SQL Server, JDBC connection URL
pohoda.sql-server.url=jdbc:sqlserver://192.168.0.1:49899;databaseName=StwPh_12345678_2020 pohoda.sql-server.username=*** pohoda.sql-server.password=*** # Seznam databází, oddělených čárkou, z minulých účetních období, pro načítání vážených nákupních cen v minulosti. pohoda.sql-server.previous-accounting-period-database-names=StwPh_12345678_2018,StwPh_12345678_2017,StwPh_12345678_2016Pro změnu portu. Výchozí port je 8100.
server.port=8100 -
Pokud je to potřeba, povolte port aplikace ve Windows Firewallu.
-
Nastavte uživateli, pod kterým jsou spouštěny importy do Pohody práva pro: iport adresáře, zásob, příjemek, výdejek, fakur přijatých, faktur vydaných a export adresáře a zásob.
-
Ověřte, že je aplikace funkční, zadáním jejího URL do browseru. Například
http://localhost:8100/vrátí stav aplikace.
¶ Řešení některých speciálních situací
¶ Vyrovnání stavů skladů ve Factorify a v Pohoda
- Před synchronizací spuťte opravu integrity dat v Pohodě.
- Synchronizujte vážené nákupní ceny ve Factorify. ( /api/pohoda/import-wap )
- Vygenerujte vyrovnávací skladové pohyby a naimportuje je do Pohody.
- Znovu spusťte opravu integrity dat v Pohodě.