Projekte / Zusatzleistungen

Attribute

{
    "id": 47266,
    "date": "2017-07-07",
    "title": "Hosting XS",
    "description": "<div>Hosting, Monitoring und Backup</div>",
    "quantity": 3,
    "unit": "Monat",
    "unit_price": 29,
    "unit_cost": 19,
    "price": 87,
    "cost": 57,
    "currency": "CHF",
    "budget_relevant": true,
    "billable": true,
    "billed": false
}


GET projects/{id}/expenses

Abruf aller Zusatzleistungen eines Projekts:

curl -X GET \
  https://{domain}.mocoapp.com/api/v1/projects/{123}/expenses \
  -H 'Authorization: Token token={api-key}'

Die Antwort liefert ein Array mit den Zusatzleistungen (siehe Attribute).


GET projects/{id}/expenses/{id}

Abruf einer einzelnen Zusatzleistung eines Projekts:

curl -X GET \
  https://{domain}.mocoapp.com/api/v1/projects/{123}/expenses/{123} \
  -H 'Authorization: Token token={api-key}'

Die Antwort ist die Repräsentation einer einzelnen Zusatzleistung.


POST projects/{id}/expenses

Erstellen einer Zusatzleistung in einem Projekt:

curl -X POST \
  https://{domain}.mocoapp.com/api/v1/projects/{123}/expenses \
  -H 'authorization: Token token={api-key}' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'date=2017-04-12&title=Hosting XS&quantity=3&unit=Monate&unit_price=29&unit_cost=19'

Pflichtfelder sind mit Stern (*) markiert:
  • date*  "2017-04-12"
  • title* – "Hosting XS"
  • quantity* – 3
  • unit* – "Monate"
  • unit_price* – 29
  • unit_cost* – 19
  • description – "Hosting, Monitoring, Backup und Wartungsarbeiten inkl..."
  • billable – true/false (Standard: true)
  • budget_relevant – true/false (Standard: false)


PUT projects/{id}/expenses/{id}

Aktualisieren einer Zusatzleistung eines Projekts:

curl -X PUT \
  https://{domain}.mocoapp.com/api/v1/projects/{123}/expenses/{123} \
  -H 'authorization: Token token={api-key}' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'unit_price=49'

Felder sind analog zur Erstellung. Aktualisierung nur möglich, solange noch nicht verrechnet.


DELETE projects/{id}/expenses/{id}

Das Löschen einer Zusatzleistung eines Projekts ist nur möglich, solange diese noch nicht verrechnet ist.

curl -X DELETE \
  https://{domain}.mocoapp.com/api/v1/projects/{123}/expenses/{123} \
  -H 'authorization: Token token={api-key}'


POST projects/{id}/expenses/disregard

Markieren von Zusatzleistungen als "bereits abgerechnet".

curl -X POST \
  https://{domain}.mocoapp.com/api/v1/projects/{123}/expenses/disregard \
  -H 'authorization: Token token={api-key}' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'expense_ids[]=47268&expense_ids[]=47269&reason=Kulanzleistung wie besprochen'

Pflichtfelder sind mit Stern (*) markiert:
  • reason*  "Kulanzleistung wie besprochen..."
  • expense_ids* – [123, 234, 345]


Mehr zu API (V1)...
30 Tage gratis

Account sofort startbereit. Voller Funktionsumfang. Ohne Zahlungsangaben.