MDRUGB

Invoice Object - API

Referință API / invoicing / Invoice Object
Schimbat: 08.04.2023 02:55

Obiect Cont/Comandă (Order)

PARAMETRU TIP DESCRIERE
id integer ID-ul facturii/comenzii „extern” din sistemul dvs. de contabilitate.
Folosit de sistemul dvs. de contabilitate ca număr unic de comandă în baza de date.
order_number string Numărul facturii/comenzii „extern” din sistemul dumneavoastră de contabilitate.
Folosit pentru reprezentarea prietenoasă cu oamenii a numărului de comandă.
amount decimal Valoarea totală a facturii/comenzii (Total) în moneda comenzii
currency string Cod valutar din trei litere, conform ISO 4217
date_created datetime Data și ora creării facturii/comenzii în formatul: AAAA-LL-ZZ hh:mm:ss
status string Starea comenzii din sistemul dvs. de contabilitate. „În așteptare” ("pending" prestabilit
customer_note string Comentariul cumpărătorului asupra facturii/comenzii. Utilizat de obicei la plasarea unei comenzi pe site-ul vânzătorului.
billing object Obiect JSON care definește contactele cu plătitorul. Vezi tabelul de mai jos.


Obiect plătitor (Client/Customer)

PARAMETRU TIP DESCRIERE
id integer ID-ul plătitorului intern în sistemul dvs. de contabilitate.
În versiunea actuală a API-ului, acesta este ignorat.
company string Numele companiei plătitorului (necompletat dacă plătitorul este o persoană fizică).
idno string Codul fiscal al plătitorului unei persoane juridice (necompletat dacă plătitorul este persoană fizică).
idnp string Codul fiscal al plătitorului unei persoane fizice (vid dacă plătitorul este persoană juridică).
first_name string Numele de contact al plătitorului.
last_name string Numele persoanei de contact a plătitorului.
address_1 string Adresa principală a plătitorului (stradă, casă etc.).
address_2 string Adresa suplimentara a platitorului (intrare, etaj, birou/apartament).
city string Oraș
postcode string Cod poștal
country string Cod de țară din două litere, conform IISO 3166-1
email string Adresa de e-mail a plătitorului. Parametru necesar. La această adresă va fi trimisă o factură.
phone string Numărul de contact al plătitorului.


Exemplu JSON de reprezentare a cone de plata/comenzii:

  "order": {
    "id": 4365,
    "order_number": "Order #4365",
    "amount": "554.30",
    "currency": "MDL",
    "date_created": "2022-11-22 13:30:52",
    "status": "pending",
    "customer_note": "Notes from customer...",
    "billing": {
      "id": 12345,
      "company": "MyCompany",
      "idno": "675546554343",
      "idnp": "",
      "first_name": "John",
      "last_name": "Smith",
      "address_1": "Stefan cel Mare 180",
      "address_2": "Floor 3",
      "city": "Chisinau",
      "postcode": "MD2001",
      "country": "MD",
      "email": "john.smith@gmail.com",
      "phone": "+37379123456"
    }
  }


Următorul