Kunder

Kunder

Kunder inneholder kontaktopplysninger og informasjon om en person eller et firma, og kan sendes fakturaer. Kunder foreslås automatisk når fakturaer opprettes i Dokus, men det er ikke nødvendig å opprette en kunde på forhånd for å sende en faktura.

Ressurs	Metode	URL
Hente alle kunder	GET	/customers/
Hente/oppdatere en kunde	GET/POST	/customers/id/
Opprette en ny kunde	POST	/customers/create/
Slette en kunde	POST	/customers/id/delete/

Felter

Eksempelet viser en kunde formattert som JSON, med feltene beskrevet under.

{
    "id": 3,
    "name": "Bentes Kafe",
    "org_number": "111111111",
    "email": "benteskafe@eksempel.no",
    "phone_number": "12345678",
    "fax_number": "23456789",
    "contact": "Bente Nordmann",
    "web_site": "http://eksempel.no",
    "customer_number": "1000",
    "address1": "Testgata 2B",
    "address2": "",
    "zip_code": "0123",
    "zip_place": "Oslo",
    "country": 1, 
    "creation_time": "2010-04-22 22:00:00",
    "creation_by": {
        "id": 1,
        "first_name": "Ole Nordmann", 
        "email": "dokus@dokus.no"
    },
    "modification_time": "2010-04-26 11:29:14",
    "modification_by": {
        "id": 1,
        "first_name": "Ole Nordmann", 
        "email": "dokus@dokus.no"
    }
}

Feltnavn	Kan endres	Beskrivelse
id	Nei	Kundens ID
name	Ja (påkrevet)	Kundens navn
org_number	Ja	Kundens organisasjonsnummer (tomt eller gyldig norsk org.nr)
email	Ja	Kundens e-postadresse
phone_number	Ja	Kundens telefonnummer
fax_number	Ja	Kundens faksnummer
contact	Ja	Navn på kontaktperson hos kunden
web_site	Ja	Kundens nettadresse
customer_number	Ja	Valgfritt kundenummer (fritekst)
address1	Ja	Første linje i kundens postadresse
address2	Ja	Andre linje i kundens postadresse
zip_code	Ja	Kundens postnummer
zip_place	Ja	Kundens poststed
country	Ja (påkrevet)	Land til kundens postadresse (1 for Norge)
creation_by	Nei	Brukeren som opprettet kunden
modification_time	Nei	Tidspunkt for siste endring
modification_by	Nei	Brukeren som gjorde siste endring