IceFact: Program de facturare gratuit - pentru Linux, Windows și MacOSX

Introducere

Ce este IceFact

Facturare

Semnificație iconițe

Setări

e-Factura

Salvează proforma

Exemple:

Structură JSON

{
    "proforma": opțional {
        "serie": "FV", opțional
        "numar": 1, opțional
        "data": "2020-01-01", opțional
        "moneda": "RON", opțional ISO 4217
        "observatii": "Observatii factura" opțional
    },

    "curs_valutar": opțional obligatoriu dacă factura este în valută {
        "moneda": "EUR", ISO 4217
        "multiplicator": 1, opțional
        "curs": 1.0000
    },

    "prestator": opțional {
        "contact": opțional {
            "nume": "IceFact Cloud API" opțional
        }
    }

    "cumparator": {
        "denumire": "Firma SRL",
        "cif": "RO123456", pentru PF - opțional sau CNP
        "nr_regcom": "J40/1234/2019", opțional
        "adresa": "Str. Principala, nr. 1", opțional
        "localitate": "Bucuresti",
        "judet": "RO-B", ISO 3166-2:RO
        "sector": "1", 1 ... 6 dacă judet=="RO-B"
        "tara": "RO", ISO 3166-1:Alpha2 Country codes
        "cod_postal": "123456", opțional
        "iban": "RO12BTRL1234567890123456", opțional
        "banca": "Banca Transilvania", opțional
        "contact": opțional {
            "nume": "Popescu Ion", opțional
            "telefon": "0722123456", opțional
            "email": "office@firma.ro", opțional,
            "ci_serie": "KZ",
            "ci_numar": "123456",
            "ci_eliberat_de": "SPCLEP SECTOR 1",
            "mij_trans": "Dacia",
            "mij_trans_nr": "B 12 ABC"
        }
    },

    "articole": [
        {
            "sku": "SKU123", opțional
            "mpn": "MPN123", opțional
            "ean": "1234567890123", opțional
            "tags": "tag1, tag2", opțional
            "serii": "serie1, serie2", opțional
            "cpv": "45233220-3", opțional
            "nc": "NC123", opțional
            "denumire": "Produs 1",
            "descriere": "Descriere produs 1", opțional
            "observatii": "Observatii produs 1", opțional
            "tara_origine": "RO", opțional ISO 3166-1:Alpha2 Country codes
            "um": "H87", coduri UBL
            "cantitate": 1,
            "pret_unitar_max_zecimale": 8, opțional
            "pret_unitar_cu_tva": 100, sau pret_unitar_fara_tva
            "pret_unitar_fara_tva": 84.03, sau pret_unitar_cu_tva
            "valoare_fara_tva": 100, opțional
            "valoare_tva": 119, opțional
            "cota_tva": "21%" obligatoriu dacă CIF-ul prestatorului este
        }                     prefixat cu "RO"
    ],

    "total": opțional {
        "valoare_fara_tva": 100, opțional
        "valoare_tva": 19, opțional
        "valoare_cu_tva": 119 opțional
    }
}

Reguli de validare:

proforma opțional
- serie
  - dacă este specificat, trebuie să aibă maximum 10 caractere
- numar
  - câmp obligatoriu dacă este prezent serie
  - dacă este specificat, trebuie să aibă maximum 200 de cifre, conform BR-RO-L155
- data
  - dacă este specificat, formatul trebuie să fie 'YYYY-MM-DD'
- moneda
  - dacă este specificat, trebuie să fie conform ISO 4217
- observatii
  - dacă este specificat, trebuie să aibă maximum 6000 caractere, conform BR-RO-A020
curs_valutar opțional obligatoriu dacă factura este în valută
- moneda
  - conform ISO 4217
- multiplicator
  - dacă este specificat, trebuie să fie un număr întreg între 1 și 1000
- curs
  - trebuie să fie un număr cu maxim 4 zecimale
  - partea întreagă trebuie să nu fie negativă
prestator opțional
- contact
  - nume
    - dacă este specificat, trebuie să aibă maximum 100 de caractere, conform BR-RO-L1004
cumparator
- denumire
  - trebuie să aibă maximum 200 de caractere, conform BR-RO-L203
- cif pentru PF - opțional sau CNP
  - câmp obligatoriu dacă este prezent nr_regcom
  - atributul fiscal conform ISO 3166-1 alpha-2
- nr_regcom
  - dacă este specificat, trebuie să fie valid
  - trebuie să aibă maximum 50 de caractere
- adresa
  - dacă este specificat, trebuie să aibă maximum 150 de caractere, conform BR-RO-L152
- localitate
  - trebuie să fie 'București' dacă judet este 'RO-B'
  - trebuie să aibă maximum 50 de caractere, conform BR-RO-L0502
- judet
  - daca tara este 'RO', trebuie sa fie conform ISO 3166-2:RO
  - trebuie să aibă maximum 50 de caractere
- sector dacă judet=="RO-B"
  - trebuie să fie un număr întreg de la 1 la 6
- tara
  - trebuie să fie conform ISO 3166-1 alpha-2
- cod_postal
  - dacă este specificat, trebuie să aibă maximum 20 de caractere, conform BR-RO-L0202
- iban
  - dacă este specificat, trebuie să fie valid
- banca
  - dacă este specificat, trebuie să aibă maximum 30 de caractere
- contact
  - nume
    - dacă este specificat, trebuie să aibă maximum 100 de caractere, conform BR-RO-L1009
  - telefon
    - trebuie să aibă maximum 100 de caractere,
      conform BR-RO-L1010
  - email
    - dacă este specificat, trebuie să aibă maximum 100 de caractere, conform BR-RO-L1011
articole
- sku
  - dacă este specificat, trebuie să aibă maximum 100 de caractere
- mpn
  - dacă este specificat, trebuie să aibă maximum 100 de caractere
- ean
  - dacă este specificat, trebuie să aibă maximum 100 de caractere
- tags
  - dacă este specificat, trebuie să aibă maximum 100 de caractere
- serii
  - dacă este specificat, trebuie să aibă maximum 100 de caractere
- cpv
  - dacă este specificat, trebuie să aibă maximum 50 de caractere
- nc
  - dacă este specificat, trebuie să aibă maximum 50 de caractere
- denumire
  - trebuie să aibă maximum 100 de caractere, conform BR-RO-L1024
- descriere
  - dacă este specificat, trebuie să aibă maximum 200 de caractere, conform BR-RO-L212
- observatii
  - dacă este specificat, trebuie să aibă maximum 300 de caractere, conform BR-RO-L303
- tara_origine
  - dacă este specificat, trebuie să fie conform ISO 3166-1:Alpha2 Country codes
- um
  - trebuie să fie conform UNECERec20
- cantitate
  - poate avea maximum 3 zecimale
- pret_unitar_max_zecimale opțional
  - număr întreg pozitiv, între 0 și 8
  - daca nu este specificat, se va considera default "8"
- pret_unitar_fara_tva mutual exclusiv
  - nu este permis să apară odată cu pret_unitar_cu_tva
  - nu este permis ca prețul unitar să fie negativ (dacă se stornează, minus se pune la cantitate)
  - poate avea maximum pret_unitar_max_zecimale zecimale
- pret_unitar_cu_tva mutual exclusiv
  - nu este permis să apară odată cu pret_unitar_fara_tva
  - nu este permis ca prețul unitar să fie negativ (dacă se stornează, minus se pune la cantitate)
  - poate avea maximum pret_unitar_max_zecimale zecimale
- valoare_fara_tva
  - poate avea maximum 2 zecimale
- valoare_tva
  - poate avea maximum 2 zecimale
- cota_tva obligatoriu dacă CIF-ul prestatorului este prefixat cu 'RO'
  - procentul se exprimă de forma 21% - adică trebuie să conțină inclusiv simbolul "%" (procent).
  - procentul nu poate fi negativ și trebuie să aibă maximum 2 zecimale
  - dacă produsul nu face obiectul TVA, trebuie specificat un cod de categorie de TVA conform UNCL5305 - cu excepția codului "S" (standard rate), care înseamnă că ar trebui să avem procent
total opțional
- valoare_fara_tva
  - poate avea maximum 2 zecimale
- valoare_tva
  - poate avea maximum 2 zecimale
- valoare_cu_tva
  - poate avea maximum 2 zecimale

Observații secțiune "proforma":

Dacă se omite serie/număr, API-ul va aloca automat următorul număr disponibil
Dacă se omite data, API-ul va folosi data curentă
Dacă se omite moneda, API-ul va folosi RON
Dacă se omite curs_valutar, API-ul va folosi 1
Dacă se omite observatii, API-ul va folosi observațiile setate de utilizator în IceFact

Observatii secțiune "prestator":

Dacă se omite contact: nume, API-ul va folosi numele emițătorului setat de utilizator în IceFact

Observații secțiune "articole":

descriere - momentan nu este implementat în IceFact
observatii - momentan nu este implementat în IceFact

Observații calcule

Dacă se specifică pret_unitar_cu_tva, pret_unitar_fara_tva va fi calculat automat pe baza cotei de TVA, fiind rotunjit la numărul de zecimale specificat în pret_unitar_max_zecimale
Pentru preț unitar se pot folosi maximum 8 zecimale
Totalurile sunt rotunjite la 2 zecimale, limită impusă de ANAF
Dacă totalurile sunt omise, vor fi calculate de API, altfel rămân intacte ca în JSON (chiar dacă sunt greșite)

Pagină actualizată la 31.10.2025 15:38

Introducere

Facturare

Setări

e-Factura

Semnătura electronică

Cloud

API IceFact

Salvează proforma

Exemple:

Structură JSON

Reguli de validare:

Observații secțiune "proforma":

Observatii secțiune "prestator":

Observații secțiune "articole":

Observații calcule

IceSoft

MENU

Legal