...
Skapar en faktura för autentiserad användare. Fakturan kan även skickas iväg via BRP:s fakturadistribution.
Anrop
HTTP POST till /invoices
...
namn | obligatorisk | exempelvärde | förklaring | Värdemängd/Datatyp | Default |
|---|---|---|---|---|---|
orderid | ja | 66 | ID till en beställning | ID |
|
| distributionmethod | nej | Namn på distribueringmetod. Giltiga värden är "email" och "centralprint21grams" | Sträng | ||
| templateid | nej(ja*) | 55 | ID till vilken rapportmall som ska användas om distribueringmetod anges | ID |
*Obligatioriskt om distributionmethod anges till "email"
Viktigt angående fakturadistribution.
- Läs först Fakturadistribution för att se vad BRP stödjer och vad som behöver göras för att komma igång med fakturadistributionen
- Om "distributionmethod" inte anges kommer fakturan att skapas och hamna i status 1 ("Ej Skickad"). Se info nedan om
...
...
- fakturastatus.
- Om "distributionmethod" anges kommer BRP försöka lägga upp fakturan för distribuering med vald metod. Går detta bra får fakturan status 9 ("Väntar på att skickas"). Går det inte bra får fakturan status 1 som ovan.
- Fakturan kommer sedan hanteras av den schemalagda aktiviteten "Fakturadistribution" som försöker skicka fakturan. Går detta bra ändras status till "Skickad" och det skrivs i fakturans historik när och till vem fakturan har skickats. (Se Faktura-dialogen > fliken "Historik"). Skulle något gå fel med utskicket sätts status på fakturan tillbaka till 1 ("Ej Skickad") med ett felmeddelande på fakturans historikflik.
- För "distributionmethod=email" krävs att beställaren har en giltig e-post adress samt att ett id till vilken rapportmall ("templateid") som ska användas anges. Id:t finns i BRP under "Rapportmallar"
- För "distributionmethod=centralprint21grams" krävs att beställaren har en giltig adress.
Exempel:
| Code Block |
|---|
APIURL/invoices.xml?apikey=338934897438&orderid=66 |
...
Se Fakturastatus för mer information om respektive status.
"Number" ändras aldrig det är en konstant. Däremot är "Value" dynamiskt beroende på locale och det kan även ändras över tid. Betydelsen ändras dock aldrig dvs "Number"=1 betyder alltid en faktura som inte är skickad, oavsett hur man språkligt uttrycker det i "Value". Använd Number och håll en egen lista med språkuttryck på er sida.
...