Funcții

Cum conectezi iFirma cu easySales: ghid complet de configurare

De echipa easySales · Actualizat 1 octombrie 2026 · 3 min citire

Cum conectezi iFirma cu easySales: ghid complet de configurare

Emite facturile comenzilor în iFirma: cheia API faktura, datele de conectare, observațiile facturii, emiterea facturilor, KSeF, luna contabilă și refuzurile frecvente.

Ce îți aduce conectarea iFirma

iFirma (ifirma.pl) este un program polonez online de contabilitate și facturare. Conectat la easySales, emite facturile comenzilor tale: easySales trimite cumpărătorul și fiecare linie a comenzii, iFirma creează și numerotează o factură internă cu TVA (faktura krajowa), iar PDF-ul facturii rămâne pe comandă. Pe marketplace-urile care acceptă facturi, cum este Allegro, factura este trimisă și marketplace-ului.

Trei lucruri de știut înainte să te apuci:

  • easySales are nevoie de cheia API „faktura”, împreună cu datele tale de conectare iFirma. iFirma are patru chei API; se folosește doar cea numită faktura. O generezi în iFirma și o lipești în easySales, împreună cu adresa de e-mail cu care te conectezi în iFirma.
  • Salvarea nu verifică cheia. Un utilizator sau o cheie greșită se vede abia la emiterea primei facturi, așa că emite o factură de test imediat după conectare.
  • Corecțiile se fac în iFirma. Anularea sau ștergerea unei facturi în easySales o scoate doar de pe comandă; factura rămâne în iFirma, unde o corectezi sau o anulezi.
Pagina Facturare din easySales, filtrată după ifirma, cu cardul iFirma conectat și insigna Beta.
Integrări → Facturare.

Înainte să începi

✓

Un cont iFirma

Pentru firma ta înregistrată în Polonia.

✓

Datele tale de conectare iFirma

Adresa de e-mail cu care te conectezi.

✓

Cheia API „faktura”

Generată în iFirma, la Konfiguracja → Rozszerzenia i integracje → API.

Pasul 1 — Generează cheia API „faktura” în iFirma

  1. Intră în contul tău de pe ifirma.pl și mergi la Konfiguracja → Rozszerzenia i integracje → API (Configurare → Extensii și integrări → API).
  2. Apasă Aktywuj dostęp podstawowy (activează accesul de bază).
  3. Apasă wygeneruj (generează) lângă cheia numită faktura și copiază cheia.

Pasul 2 — Conectează iFirma în easySales

Mergi la Integrări → Facturare, caută ifirma și apasă Conectează pe cardul iFirma — sau Editează, dacă l-ai mai conectat înainte.

Conexiunea iFirma: Nume conexiune iFirma magazin online, Utilizator (Email) biuro@demo-sklep.pl, Token, Scutit de TVA Nu și Incasează facturile cu chitanță Nu.
Datele tale de conectare iFirma și cheia faktura.
Câmp Ce completezi
Nume conexiune Un nume după care o recunoști, folosit doar în easySales.
Utilizator (Email) Adresa de e-mail cu care te conectezi în iFirma.
Token Cheia API faktura de la pasul 1.
Scutit de TVA Nu pentru un plătitor de TVA.
Sabloane Textul observațiilor facturii — vezi pasul 3.
Conexiunea

Pasul 3 — Observațiile facturii

Câmpul Sabloane cu butoanele de variabile pentru comandă și produse și textul Comanda ${order.id}.
Textul observațiilor facturii.

În Sabloane scrii textul care apare la observațiile (Uwagi) fiecărei facturi. Apasă butoanele ca să adaugi datele comenzii — ID-ul comenzii, platforma, numărul AWB, metoda de plată — sau scrie propriul text.

Arată opțiuni avansate deschide încă câteva variante: produsele cadou ca discount separat, eliminarea caracterelor speciale din datele cumpărătorului, o garanție emisă odată cu fiecare factură și lăsarea discounturilor în afara facturii.

Apasă Salvare, apoi emite o factură de test dintr-o comandă.

Emiterea facturilor

  • Din comandă: în secțiunea Facturi a comenzii, apasă Creare factură și alege iFirma.
  • În bloc: selectează comenzile în lista de comenzi, deschide Acțiuni, alege Generare factură și apoi iFirma. Fiecare comandă primește propria factură.
  • Automat: în Fluxuri, adaugă acțiunea Creează factură cu conexiunea ta iFirma.

Ce primește iFirma:

  • Cumpărătorul: numele firmei sau al clientului, adresa de facturare, e-mailul și telefonul.
  • Liniile: fiecare produs cu cantitatea, prețul brut și cota de TVA din comandă, iar transportul pe o linie separată.
  • Datele: data emiterii este ziua în care emiți factura, data vânzării este data comenzii.
  • Numărul: iFirma numerotează factura.

KSeF

easySales nu trimite nimic în KSeF pentru facturile iFirma: o face iFirma, după propriile setări KSeF. În iFirma, la KSeF → Konfiguracja KSeF (configurare KSeF), alegi dacă facturile emise prin API sunt trimise în KSeF automat sau la cerere.

Când iFirma refuză o factură

Motivul apare pe comandă:

Mesaj Ce faci
Pole 'Data wystawienia' musi być zgodna z miesiącem i rokiem księgowym Luna contabilă din iFirma nu este cea curentă. Trece-o pe luna curentă în iFirma și emite din nou factura.
The invoice issue date cannot be later than the 15th day of the month following the month of sale. Regulile poloneze permit emiterea facturii până în a 15-a zi a lunii de după vânzare. Facturile pentru comenzile mai vechi emite-le direct în iFirma.
IFirma Error: Pole 'Cena jedn. brutto' musi być większe od 0 O linie a comenzii are prețul 0, de exemplu un cadou gratuit. iFirma nu acceptă linii fără preț.
Refuzuri frecvente

Întrebări frecvente

Cheia numită faktura. O generezi în iFirma, la Konfiguracja → Rozszerzenia i integracje → API, după ce apeși Aktywuj dostęp podstawowy.

Adresa de e-mail cu care te conectezi în iFirma.

Doar pentru peste 1.000 de facturi pe lună. Altfel, accesul de bază (dostęp podstawowy) este suficient.

Emite o factură dintr-o comandă. Dacă apare pe comandă cu PDF-ul ei din iFirma, funcționează; dacă nu, motivul apare pe comandă.

Nu, le trimite iFirma. Configurezi asta în iFirma, la KSeF → Konfiguracja KSeF.

În iFirma. Anularea sau ștergerea facturii în easySales doar o scoate de pe comandă.

iFirma acceptă facturi doar în luna contabilă deschisă în contul tău. Trece-o pe luna curentă în iFirma, apoi emite din nou factura.

A fost util acest ghid?