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,
    "file_url": "https//meinefirma.mocoapp.com/.../beleg1.jpg"
}

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)

POST projects/{id}/expenses/bulk

Erstellen mehrerer Zusatzleistungen:

curl -X POST \
  https://{domain}.mocoapp.com/api/v1/projects/{123}/expenses/bulk \
  -H 'authorization: Token token={api-key}' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'bulk_data[][date]=2017-10-20&bulk_data[][title]=Hosting&bulk_data[][quantity]=1&bulk_data[][unit]=Server&bulk_data[][unit_price]=29&bulk_data[][unit_cost]=19' \
  -d 'bulk_data[][date]=2017-10-21&bulk_data[][title]=Hosting&bulk_data[][quantity]=1&bulk_data[][unit]=Server&bulk_data[][unit_price]=29&bulk_data[][unit_cost]=19' \
  -d 'bulk_data[][date]=2017-10-22&bulk_data[][title]=Hosting&bulk_data[][quantity]=1&bulk_data[][unit]=Server&bulk_data[][unit_price]=29&bulk_data[][unit_cost]=19' 

Pflichtfelder sind mit Stern (*) markiert:
  • bulk_data[][date]*  "2017-04-12"
  • bulk_data[][title]* – "Hosting XS"
  • bulk_data[][quantity]* – 3
  • bulk_data[][unit]* – "Monate"
  • bulk_data[][unit_price]* – 29
  • bulk_data[][unit_cost]* – 19
  • bulk_data[][description] – "Hosting, Monitoring, Backup und Wartungsarbeiten inkl..."
  • bulk_data[][billable] – true/false (Standard: true)
  • bulk_data[][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...
30 Tage gratis

Account sofort startbereit. Voller Funktionsumfang. Ohne Zahlungsangaben.