Arbetsdagar

Dokumentation API

Med API:et för arbetsdagar kan du beräkna antal arbetsdagar och dagar mellan två datum. Du får också en lista med alla helgdagar som infaller på en vardag mellan de datum du anger. Du kan också få reda på när ett datum för ett visst antal arbetsdagar framåt i tiden inträffar. Du kan använda datum mellan 1970-01-01 och 2029-12-31.

För att använda API:et behöver du en nyckel. Du får en nyckel när du registrerar dig på sajten. Nyckeln använder du sedan i alla anrop till API:et.

Alla funktioner anropas med GET. Resultatet kan fås antingen i XML- eller JSON-format.

Funktionerna returnerar status som kan antingen vara "OK" eller "Fel". Om något fel inträffar anges orsaken i meddelande-fältet.


Funktioner

Dagar

Ger som resultat antal dagar, antal vardagar och antal arbetsdagar samt en lista med de helgdagar som infaller på en vardag mellan två datum.

  • fran: Ange ett startdatum. Du anger datum i formen ÅÅÅÅ-MM-DD, t.ex. 2013-02-26, men kan också ange idag eller imorgon för dagens datum eller morgondagens datum.
  • till: Ange ett slutdatum. Du anger datum i formen ÅÅÅÅ-MM-DD, t.ex. 2013-02-26, men kan också ange idag eller imorgon för dagens datum eller morgondagens datum.
  • key: Ange den nyckel som du får när du registrerar dig
  • id: Valfritt. Returneras i resultatet och påverkar inte någon beräkning.
Exempel:

Ger som resultat antal dagar, antal vardagar och antal arbetsdagar samt en lista med de helgdagar som infaller på en vardag mellan idag och 1 april.

JSON:
http://api.arbetsdag.se/v1/dagar.json?fran=idag&till=2013-04-01&key=NYCKEL&id=1234
Resultat:
{"status":"OK", 
 "meddelande":"", 
 "fran":"2013-03-13", 
 "till":"2013-04-01", 
 "antal_dagar":20, 
 "antal_vardagar":14, 
 "antal_arbetsdagar":12, 
 "antal_helgdagar":2, 
 "helgdagar":
  [
    {"datum":"2013-01-01",
     "helgdag":"Fre 2013-03-29: L\u00e5ngfredag"},
    {"datum":"2013-04-01", 
     "helgdag":"M\u00e5n 2013-04-01: Annandag p\u00e5sk"}
  ], 
"id":"1234"}
XML:
http://api.arbetsdag.se/v1/dagar.xml?fran=idag&till=2013-04-01&key=NYCKEL&id=1234
Resultat:
<xml>
   <status>OK</status>
   <meddelande/>
   <fran>2013-03-13</fran>
   <till>2013-04-01</till>
   <antal_dagar>20</antal_dagar>
   <antal_vardagar>14</antal_vardagar>
   <antal_arbetsdagar>12</antal_arbetsdagar>
   <antal_helgdagar>2</antal_helgdagar>
   <helgdagar>
      <item>
         <datum>2013-03-29</datum>
         <helgdag>Fre 2013-03-29: Långfredag</helgdag>
      </item>
      <item>
         <datum>2013-04-01</datum>
         <helgdag>Mån 2013-04-01: Annandag påsk</helgdag>
      </item>
   </helgdagar>
   <id>1234</id>
</xml>

 


Nästa arbetsdag

Ger som resultat ett datum ett visst antal arbetsdagar räknat från ett startdatum.

  • fran: Ange ett datum du vill räkna från. Du anger datum i formen ÅÅÅÅ-MM-DD, t.ex. 2013-02-26, men kan också ange idag eller imorgon för dagens datum eller morgondagens datum.
  • dagar: Antal arbetsdagar, t.ex. 5.
  • key: Ange den nyckel som du får när du registrerar dig
  • id: Valfritt. Returneras i resultatet och påverkar inte någon beräkning.
Exempel:

Ger som resultat ett datum räknat från idag (2013-03-13) och 15 arbetsdagar framåt.

JSON:
http://api.arbetsdag.se/v1/nasta_arbetsdag.json?fran=idag&dagar=15&key=NYCKEL&id=1234
Resultat:
{"status":"OK", 
 "meddelande":"", 
 "fran":"2013-03-13", 
 "dagar":15, 
 "arbetsdag":"2013-04-03", 
 "id":"1234"}
XML:
http://api.arbetsdag.se/v1/nasta_arbetsdag.xml?fran=idag&dagar=15&key=NYCKEL&id=1234
Resultat:
<xml>
   <status>OK</status>
   <meddelande/>
   <fran>2013-03-13</fran>
   <dagar>15</dagar>
   <arbetsdag>2013-04-03</arbetsdag>
   <id>1234</id>
</xml>

Version

API version 1 från 2013-03-13.


Mallverkstan

Vi är ett konsultföretag som utvecklar administrativa lösningar, webb-lösningar och databaser för produktinformation.

Läs mer på www.mallverkstan.se
 

Icon Image

Mallverkstan i Lund AB
Annedalsvägen 9
227 64 LUND
Tel 046-23 52 50
Epost info@mallverkstan.se

Appar för iOS

Vi utvecklar också appar för iOS (iPhone/iPad) med FileMaker Go, t.ex. för mobil arbetsorder, produktpresentation, ordermottagning m.m.

Vi är certifierade utvecklare av FileMaker-lösningar och FileMaker Platinum Partner.

API för Arbetsdagar

Vårt API finns nu tillgängligt i en första version. Läs mer och registrera dig!