invoice-gen

Instalacja

[dependencies]
invoice-gen = "0.0.3"

Użycie

FA (3)

use invoice_gen::fa_3::builder::{SellerBuilder, BuyerBuilder, LineBuilder};
use invoice_gen::fa_3::models::Invoice;
use rust_decimal::Decimal;
use std::str::FromStr;

let seller = SellerBuilder::new("5261234567", "Firma Sprzedająca Sp. z o.o.")
    .set_address("PL", "ul. Przykładowa", "1", None, "Warszawa", "00-001")
    .build();

let buyer = BuyerBuilder::new("9876543210", "Klient S.A.")
    .set_address("PL", "ul. Kupiecka", "5", None, "Warszawa", "00-100")
    .build();

let line = LineBuilder::new(
    "Produkt",
    Decimal::new(10, 0),
    Decimal::from_str("25.00").unwrap(),
    invoice_gen::shared::models::TaxRate::from_str("23").unwrap(),
)
.build();

let mut invoice = Invoice::default();
invoice.subject1 = seller;
invoice.subject2 = buyer;
invoice.invoice_body.invoice_number = "FV/2026/0001".to_string();
invoice.invoice_body.issue_date = chrono::Local::now().format("%Y-%m-%d").to_string();
invoice.invoice_body.currency_code = invoice_gen::shared::models::CurrencyCode::new("PLN");
invoice.invoice_body.lines = vec![line];

let xml = invoice.to_xml().unwrap();
println!("{}", xml);

FA (2)

use invoice_gen::fa_2::builder::{SellerBuilder, BuyerBuilder, LineBuilder, InvoiceBuilder};
use rust_decimal::Decimal;
use chrono::NaiveDate;

let seller = SellerBuilder::new("5261234567", "Firma").set_address("PL","U","1",None,"M","00-000").build();
let buyer  = BuyerBuilder::new("9876543210","Klient").set_address("PL","U","2",None,"M","00-000").build();
let l1 = LineBuilder::new("A","pcs",Decimal::from_str("1").unwrap(),Decimal::from_str("100").unwrap(),"23").build();

let inv = InvoiceBuilder::new()
    .set_invoice_number("FV/1")
    .set_issue_date(NaiveDate::from_ymd_opt(2023,1,1).unwrap())
    .set_currency("PLN")
    .set_seller(seller)
    .set_buyer(buyer)
    .add_lines(vec![l1])
    .build()
    .unwrap();

let xml = inv.to_xml().unwrap();
println!("{}", xml);

SellerBuilder

new(nip: &str, name: &str) -> SellerBuilder

nip: NIP sprzedawcy
name: nazwa sprzedawcy

set_address(self, country_code: &str, street: &str, building_number: &str, flat_number: Option<&str>, city: &str, postal_code: &str) -> SellerBuilder

country_code: kod kraju (PL)
street: ulica
building_number: numer budynku
flat_number: numer lokalu (opcjonalny)
city: miasto
postal_code: kod pocztowy

build(self) -> Subject1 (Obiekt reprezentujący sprzedawcę)

BuyerBuilder

new(nip: &str, name: &str) -> BuyerBuilder

nip: NIP nabywcy
name: nazwa nabywcy

set_address(self, country_code: &str, street: &str, building_number: &str, flat_number: Option<&str>, city: &str, postal_code: &str) -> BuyerBuilder

country_code: kod kraju (PL)
street: ulica
building_number: numer budynku
flat_number: numer lokalu (opcjonalny)
city: miasto
postal_code: kod pocztowy

build(self) -> Subject2 (Obiekt reprezentujący nabywcę)

LineBuilder

new(name: &str, measure_unit: &str, quantity: Decimal, net_price: Decimal, tax_rate: &str) -> LineBuilder

name: nazwa towaru lub usługi
measure_unit: jednostka miary (np. "szt")
quantity: ilość
net_price: cena netto jednostkowa
tax_rate: stawka VAT (np. "23", "8", "zw")

build(self) -> InvoiceLine (Obiekt reprezentujący wiersz faktury)

InvoiceBuilder

new() -> InvoiceBuilder

set_invoice_number(self, s: &str) -> InvoiceBuilder

s: numer faktury

set_issue_date(self, date: NaiveDate) -> InvoiceBuilder

date: data wystawienia

set_sale_date(self, date: NaiveDate) -> InvoiceBuilder

date: data sprzedaży

set_currency(self, code: &str) -> InvoiceBuilder

code: kod waluty (np. "PLN")

set_seller(self, seller: Subject1) -> InvoiceBuilder

seller: obiekt sprzedawcy (z SellerBuilder)

set_buyer(self, buyer: Subject2) -> InvoiceBuilder

buyer: obiekt nabywcy (z BuyerBuilder)

add_line(self, line: InvoiceLine) -> InvoiceBuilder

line: wiersz faktury (z LineBuilder)

add_lines(self, lines: Vec<InvoiceLine>) -> InvoiceBuilder

lines: wektor wierszy faktury

set_exemption(self, exempt_delivery: u8, exempt_delivery_none: Option<u8>, basis_text: Option<&str>, _legacy_basis: Option<&str>, basis_directive: Option<&str>) -> InvoiceBuilder

exempt_delivery: znacznik zwolnienia (1 - zwolnienie, 0 - brak)
exempt_delivery_none: opcja (zazwyczaj None jeśli jest zwolnienie)
basis_text: podstawa prawna zwolnienia
basis_directive: dyrektywa unijna
_legacy_basis: parametr przestarzały (nieużywany)

set_new_transport(self, is_new_transport: u8, is_new_transport_intra_community: Option<u8>) -> InvoiceBuilder

is_new_transport: czy jest to nowy środek transportu
is_new_transport_intra_community: WDT nowego środka transportu

set_margin_procedures(self, tourism_services: Option<u8>, used_goods: Option<u8>, works_of_art: Option<u8>, collector_items: Option<u8>, antiques: Option<u8>) -> InvoiceBuilder

tourism_services: procedura marży dla biur podróży
used_goods: procedura marży - towary używane
works_of_art: procedura marży - dzieła sztuki
collector_items: procedura marży - przedmioty kolekcjonerskie
antiques: procedura marży - antyki

build(self) -> Result<Invoice, String>

PEF (UBL)

use invoice_gen::pef_3::builder::{
    InvoiceBuilder, InvoiceLineBuilder, MonetaryTotalBuilder, PartyBuilder,
    PostalAddressBuilder, TaxTotalBuilder,
};

let address = PostalAddressBuilder::new()
    .city_name("Warszawa")
    .country("PL")
    .build();

let supplier = PartyBuilder::new()
    .party_legal_entity("Seller Name Ltd.", None)
    .postal_address(address.clone())
    .party_tax_scheme("PL5261234567", "VAT")
    .build();

let customer = PartyBuilder::new()
    .party_legal_entity("Buyer Name S.A.", None)
    .postal_address(address)
    .build();

let total = MonetaryTotalBuilder::new()
    .line_extension_amount("PLN", "100.00")
    .tax_exclusive_amount("PLN", "100.00")
    .tax_inclusive_amount("PLN", "123.00")
    .payable_amount("PLN", "123.00")
    .build();

let tax_total = TaxTotalBuilder::new()
    .tax_amount("PLN", "23.00")
    .add_subtotal("100.00", "23.00", "PLN", "S", "23", "VAT")
    .build();

let line = InvoiceLineBuilder::new("1")
    .invoiced_quantity("EA", "1.0")
    .line_extension_amount("PLN", "100.00")
    .item("Item Name")
    .price_amount("PLN", "100.00")
    .tax_category("S", "23", "VAT")
    .build();

let invoice = InvoiceBuilder::new(
    "INV-001",
    "2024-01-01",
    supplier,
    customer,
    total,
    vec![line],
)
.due_date("2024-01-15")
.add_tax_total(tax_total)
.build();

let xml = invoice.to_xml().unwrap();
println!("{}", xml);

InvoiceBuilder (PEF)

new(id: impl Into<String>, issue_date: impl Into<String>, accounting_supplier_party: PartyType, accounting_customer_party: PartyType, legal_monetary_total: MonetaryTotal, invoice_line: Vec<InvoiceLine>) -> InvoiceBuilder

due_date(self, date: impl Into<String>) -> InvoiceBuilder

date: data płatności

add_tax_total(self, total: TaxTotal) -> InvoiceBuilder

total: suma podatkowa (z TaxTotalBuilder)

build(self) -> Invoice

PartyBuilder

new() -> PartyBuilder

party_legal_entity(self, registration_name: impl Into<String>, company_id: Option<Identifier>) -> PartyBuilder

registration_name: nazwa prawna (wymagane dla BR-06/BR-07)

party_name(self, name: impl Into<String>) -> PartyBuilder

name: nazwa handlowa

postal_address(self, address: PostalAddress) -> PartyBuilder

address: adres (z PostalAddressBuilder)

party_tax_scheme(self, company_id: impl Into<String>, tax_scheme_id: impl Into<String>) -> PartyBuilder

company_id: numer podatkowy (np. NIP)
tax_scheme_id: identyfikator schematu (np. VAT)

build(self) -> PartyType

MonetaryTotalBuilder

new() -> MonetaryTotalBuilder

line_extension_amount(self, currency: impl Into<String>, value: impl Into<String>) -> MonetaryTotalBuilder

Suma wartości netto linii

tax_exclusive_amount(self, currency: impl Into<String>, value: impl Into<String>) -> MonetaryTotalBuilder

Suma netto faktury

tax_inclusive_amount(self, currency: impl Into<String>, value: impl Into<String>) -> MonetaryTotalBuilder

Suma brutto faktury

payable_amount(self, currency: impl Into<String>, value: impl Into<String>) -> MonetaryTotalBuilder

Kwota do zapłaty

build(self) -> MonetaryTotal

InvoiceLineBuilder

new(id: impl Into<String>) -> InvoiceLineBuilder

invoiced_quantity(self, unit_code: impl Into<String>, value: impl Into<String>) -> InvoiceLineBuilder

Ilość zafakturowana

line_extension_amount(self, currency: impl Into<String>, value: impl Into<String>) -> InvoiceLineBuilder

Wartość netto linii

item(self, name: impl Into<String>) -> InvoiceLineBuilder

Nazwa towaru/usługi

price_amount(self, currency: impl Into<String>, value: impl Into<String>) -> InvoiceLineBuilder

Cena jednostkowa netto

tax_category(self, id: impl Into<String>, percent: impl Into<String>, tax_scheme_id: impl Into<String>) -> InvoiceLineBuilder

Kategoria podatkowa (np. S, 23, VAT)

build(self) -> InvoiceLine

invoice-gen 0.0.4