Først og fremmes tak for din interesse i vores API.
Du har ret i at vi ikke har mange eksempler på integration mellem PHP og vores API, vores primære kompetencer ligger i .NET integrationen, men vi har stillet API’et til rådighed for PHP integration, men vi supportere ikke PHP.
Vi har nu oprettet et API Forum, hvor vores håb er at andre PHP brugere af vores API kan komme med gode tip og tricks http://techtalk.e-conomic.com/ Du skal også være meget velkommen til selv at komme med dine erfaringer.

mvh
Christian Wendel
Developer
E-conomic A/S

Kunne virkelig godt kunne bruge nogen flere eksempler på hvad man kan – den ene fil som er med der kun viser nogen få eksempler er langt fra nok.

Vi beder selv om de hårde facts – og derfor stor tak for jeres input.

Indrømmet, fra at vores API har været en mulighed, en ekstra feature ved e-conomic er vi på interne linjer nået dertil at det vil blive en afgørende del af “the e-conomic way”.

At det er “absurd” at gennemtravle vores dokumentation tror jeg næppe, men jeg er i øvrigt enig i at vi kan gøre det meget tydeligere hvad vi kan og vil understøtte.

I tak med at vi har rundet 15.000 virksomheder er der flere hundrede “travle udviklere” som Gustav skriver, der ser fordele ved at integrere med e-conomic. Tak for det.

Jeg skal ikke love bedre vejr eller løsninger i morgen – væsentligt er at jo mere I stiller krav til os – des mere deler i vores billede af at et rigt og agilt API er afgørende for os.

Mit oprindelige indlæg fra februar er i øvrigt det mest kommenterede her på bloggen og er næsten endt som overskriften lyder: Nogle gode historier og også nogle hårde facts om hvor vi kan gøre det bedre. Keep it coming – både der hvor I er lykkedes og der hvor vi kan gøre det bedre.

Vores API er jo også tilgængeligt i resten af verden, primært UK, NO, SE og DK (og de vel 25 andre lande e-conomic har spredt sig til)

Vi ønsker derfor at tilbyde et særligt API-forum (på engelsk – og mere faktuelt end denne blog og hjemmesidens glamour) hvor alle erfaringer – gode og dårlige – kan udnyttes af andre udviklere.

Input til hvordan dette forum skal opbygges er særdeles velkomne ! ?

hilsen
Anders K.

Du kan med andre ord integrere webshoppen, kasseapparatet, CRM-systemet eller et helt fjerde system med e-conomic og på den måde få systemerne til at udveksle data om kunder, korrespondancer, varer, priser, lagerbeholdninger og meget andet.

Men ak, det er halvvejs lyv. Hverken prislister eller fx lagre er der adgang til, for “API’et omfatter kun standardmodulet” – finder man ud af efter megen søgen og undren.

Det er jo en ærlig sag og da så absolut bedre end ingenting, men udviklere er travle mennesker, der hader at spilde tid på banaliteter og blindgyder.

Løsningen er naturligvis at tydeliggøre, hvad API’et ikke kan, så man slipper for den absurde opgave at skulle nærlæse oversigten her:

e-conomic_API_model_1.4.0.pdf

for at finde ud, hvad der _ikke_ er med.

For det, der mangler, burde der enten være en roadmap eller være en tydelig markering af, at det ikke bliver lavet.

Den mangelfulde dokumentation kommenteres i flere af indlæggene. Et generelt råd er, at der næsten ikke kan være for mange eksempler. Tit er et velforklaret eksempel langt det mest lærerige.

Vi ville for længe siden ha’ vores egenudviklet backend til at kommunikere med e-conomic, så systemet let kunne oprette fakturaer når kunder foretog bestillinger/køb. Vores daværende udvikler gav op. Dokumentationen var simpelthen for ringe.

Nu står vi der igen og havde håbet, at I havde brugt den mellemlæggende tid på at forbedre dokumentationen (SOAP) eller i det skrive et par “Best Practice” eksempler/eksempler på kode, der opretter en faktura og deslige. Det må alt andet lige være en super simpel opgave for jer, når det er jeres eget API.

Hermed endnu en gang en opfordring til, at I får skrevet lidt brugbar kodeeksempler til SOAP.

Mvh, Lasse

Jeg har sendt dit gode forslag videre til vores API-folk. De står i øvrigt parat for at hjælpe og træffes nemmest via api@e-conomic.com.

Er det et mere generelt interface du er igang med vil vi meget gerne viderebringe information til andre e-conomic brugere.

Du har ikke efterladt en mailadresse. Hvis du stadig søger hjælp så skriv gerne direkte til api@e-conomic.com eller til mig på akh@e-conomic.com

hilsen
Anders K

Jeg har som andre her på bloggen svært ved at gennemskue hvordan man laver en faktura, så hvis der er nogen der kan poste et eksempel vil jeg være meget taknemlig.

Jeg synes det er ærgeligt at man lægger så mange kræfter i at lave et API og dokumentation så ikke følger med. Som der er andre der har skrevet burde det eksempel som følger med også indeholde opret af faktura.

Ellers må jeg sige at det er suverænt at der følger et API med jeres system.

Mhv
Kim Johansen

Derfor, for en ordens skyld: Hvis Remainder[BaseCurrency] IKKE ER LIG MED 0, er fakturaen udestående.

Mvh.

Christian Estrup
E-conomic

Selvom der ikke er eksplicit adgang til at læse selve debitor-indbetalings-posterne, er der måske alligevel noget, du kan bruge (med udgangspunkt i .NET-API’et – samme funktionalitet er dog naturligvis også tilgængelig i SOAP):

IInvoice-klassen har to felter – Remainder og RemainderBaseCurrency – som eksponerer det endnu ikke udlignede beløb på fakturaen. Remainder er i fakturaens valuta, mens RemainderBaseCurrency er i regnskabets grundvaluta (sandsynligvis DKK).

For at disse felters indhold skal være retvisende, kræver det naturligvis, at evt. indbetalinger er udlignet korrekt mod den pågældende faktura – dette gøres lettest og mest automatisk ved at påføre fakturanummeret ifm. oprettelsen af indbetalings-posterne.

Som sagt er det selvfølgelig ikke det samme som at kunne se ‘selve’ indbetalingerne – men de fleste lignende behov, vi er stødt på, har faktisk reelt bundet i behovet for at kunne trække udestående fakturaer, hvilket dette netop giver en let mulighed for (-> hvis Remainder[BaseCurrency] 0, er fakturaen helt eller delvist udestående).

Mvh.

Christian Estrup
E-conomic

Tak for input.

Indrømmet så er vi blevet overrasket over hvor mange der rent faktisk er gået i gang med API-integrationerne.

Faktisk – og for os både glædeligt – men også lidt pinligt støder vi ofte på integrationer vi ikke anede eksisterende.

Glædeligt fordi det viser at vores API virker.

Ærgeligt fordi vi meget gerne vil have et forum hvor disse interfaces kan komme så mange til gode som muligt. (ikke opfinde dybe tallerkener igen….)

Også ærgeligt hvis I bruger forgæves timer på områder vi (endnu) ikke understøtter. F.eks Keld Bentsens problemer med PHP i tidligere indlæg.

Jeg ved at der foregår nogen dialog på http://www.amino.dk som vi følger med i lige, ligesom API har været et velbesøgt område her på denne “forsøgsblog”.

Vores mål er jo selvfølgelig at få et så kompetent miljø omkring vores integrationer som muligt. B

Bag linierne arbejder vi på at lave et egentligt API-forum – forhåbentlig ind over sommeren. Det bliver sikkert noget WIKI, Blog lignende hvor vi håber I vil blive animeret til at deltage.

Gode forslag til et API-forum modtages meget gerne på akh@e-conomic.com

hilsen
Anders K.

Jeg har dog et par forslag til forbedringer. Dels kunne jeg rigtigt godt tænke mig at I afsatte en udvikler til at lave en række ”Best practices” eksempler. Altså programmer der også skalere godt hvis der er mange poster der skal hentes etc. Dette vil støtte op om den dokumentation er engang er. De programstumper der medfølger API’et dækker kun en lille del af API’et. Desuden kunne også godt tænke mig at man offentliggjorte en roadmap for den påtænkte udvikling, ie hvilke moduler man

Pt. kunne jeg ønske mig adgang til abonnent modulet, samt viden om hvordan jeg udtrækker information om de beløb debitor har indbetalt og ikke blot hvilke faktura de har modtaget.

Venlig hilsen
Erik Arndal

Forudsætninger:
Sprog: PHP5 + SOAP
Integration med: Egen backend
Stor erfaring med PHP
Ingen erfaring med SOAP.

Vi valgte E-conomic pga den lette tilgængelighed og muligheden for API samt abonnementsmodulet.

Desværre viste det sig, at abonnementsmodulet ikke kan styres via API. Det var første slag. (Man skal lede meget længe for at se hvad API’et understøtter, for det står ikke nogen steder. Kun at ‘alt’ kan lade sig gøre med API.)

Så valgte vi selv at skrive et abonnements modul til vores backend, hvilket ikke er et stort problem, men burde have været overflødigt.

Næste udfordring er så, at alle kunder skal oprettes i E-conomic. Det er lykkedes med API’et. Var lidt besværligt at finde ud af, men al begyndelse er som bekendt svær.

Nu er vi så nået til det punkt hvor der skal oprettes faktura i E-conomic via API. Det har vist sig at være noget nær umuligt for os. Det hænger nok i stor stil sammen med erfaringen med webservices. Men stadig kunne en smule mere dokumentation til PHP være ønskeligt.

Med alle de sager i kender til, må i have mulighed for at offentliggøre en række eksempler på oprettelse af debitor, oprettelse af faktura, oprettelse af kreditnota og evt et par andre.

Nuvel det er et forholdsvist billigt system at benytte, men derfor er det alligevel forventeligt at kunne få svar på spørgsmål hurtigere end 24-36 timer. Det er meeeeget længe at vente på et ‘Nej deet kan desværre ikke lade sig gøre’.

Hvis ikke ‘en fra API-teamet kan svare, må der være andre ude i lille Danmark som kan komme med de vise sten. Hvordan kommer vi videre med integrationen så vi kan oprette faktura og få dem sendt afsted?

Jeg kan kontaktes på kb@liiwin.dk.

Med venlig hilsen
Keld Bendtsen

Nok er ovenstående post et par måneder gammel, men alligevel vil jeg lige komme med en kommentar.

Selvfølgelig savner vi også API til abonnementsmodulet. Vi har spurgt løbende til dette lige fra abonnementsmodulets fødsel, næsten (det er vel efterhånden flere år). Og hver gang bliver svaret: “Det kommer på en liste over ønskede features”.

Nu har vi nedjusteret vores forventninger kraftigt, og håber nu på en meget simpel eksport til csv-fil (som i de glade 80′ere).

Vores nedjusteret behov er ret enkelt faktisk:

Til hvert abonnement (abonnementsnummer) vil vi gerne kunne hente en csv-fil (el. lignende eksportfil) med debitorerne og deres tilhørende felter.

Måske dette kunne blive en feature i “Eksportér data” under “Indstillinger” indtil API er klart om et par år?

Resten af E-conomic-systemet er vi dog tilfredse med, men da vi bruger abonnementmodulet meget, så er vi lige nu endt med at sidde og trække upræcise oplysninger ud fra andre csv-filer, som _er_ tilgængelige og derved gætte på hvordan tingene hænger sammen i abonnementerne.

Vi har også tilbudt at spytte penge i kassen til udvikling af de features vi har brug for, men har heller ikke fået svar på dette.

Mvh.
Lars

Fra en ellers generelt tilfreds bruger

/Martin

/Martin

Det kunne være rart at høre, om andre også oplever et behov for bedre rapportering på abonnementsmodulet og at kunne tilgå det gennem vores API?

Christian
e-conomic

Noget jeg mangler i economic generelt, er bedre rapportering på abonnementsmodulet. Vi benytter dette modul meget, og mangler overblik over på hvilke måneder vores abonnenter falder i forbindelse med budgettering. Jeg har nævnt det for jer før, men det har sikkert ikke haft prioritet. Nu er mit spørgsmål så, om det er muligt at tilgå abonnementsmodulet via APIét som vi selv kan lave vores rapportering ?

Tak for input.

Du har helt ret. Da vi frigav API prioriterede vi ikke projektmodulet og det er derfor ikke generelt tilgængelig via vores AP – et ærligt bud er at bladene skal nå at falde af træerne inden det bliver tilfældet.

Du har ikke efterladt kontaktinfo. Skriv eventuelt specifikt til vores API-team på api@e-conomic.com for at se om de alligevel ser en hurtig vej frem.

Anders
e-conomic

Hvornår åbner i op for det?

Er der andre der har oplevet lignende problemer med API’et?

En helt simpel proces som at lave og bogføre en faktura kræver jo nærmest ugers detektivarbejde.