cfdi

type FoodVouchers struct {
	// Customer's employer registration number (maps to `registroPatronal`).
	EmployerRegistration string `json:"employer_registration,omitempty" jsonschema:"title=Employer Registration"`
	// Customer's account number (maps to `numeroDeCuenta`).
	AccountNumber string `json:"account_number" jsonschema:"title=Account Number"`
	// Sum of all line amounts (calculated, maps to `total`).
	Total num.Amount `json:"total" jsonschema:"title=Total" jsonschema_extras:"calculated=true"`
	// List of food vouchers issued to the customer's employees (maps to `Conceptos`).
	Lines []*FoodVouchersLine `json:"lines" jsonschema:"title=Lines"`
}

type FoodVouchersEmployee struct {
	// Employee's tax identity code (maps to `rfc`).
	TaxCode cbc.Code `json:"tax_code" jsonschema:"title=Employee's Tax Identity Code"`
	// Employee's CURP ("Clave Única de Registro de Población", maps to `curp`).
	CURP cbc.Code `json:"curp" jsonschema:"title=Employee's CURP"`
	// Employee's name (maps to `nombre`).
	Name string `json:"name" jsonschema:"title=Employee's Name"`
	// Employee's Social Security Number (maps to `numSeguridadSocial`).
	SocialSecurity cbc.Code `json:"social_security,omitempty" jsonschema:"title=Employee's Social Security Number"`
}

type FoodVouchersLine struct {
	// Line number starting from 1 (calculated).
	Index int `json:"i" jsonschema:"title=Index" jsonschema_extras:"calculated=true"`
	// Identifier of the e-wallet that received the food voucher (maps to `Identificador`).
	EWalletID cbc.Code `json:"e_wallet_id" jsonschema:"title=E-wallet Identifier"`
	// Date and time of the food voucher's issue (maps to `Fecha`).
	IssueDateTime cal.DateTime `json:"issue_date_time" jsonschema:"title=Issue Date and Time"`
	// Employee that received the food voucher.
	Employee *FoodVouchersEmployee `json:"employee,omitempty" jsonschema:"title=Employee"`
	// Amount of the food voucher (maps to `importe`).
	Amount num.Amount `json:"amount" jsonschema:"title=Amount"`
}

type FuelAccountBalance struct {
	// Customer's account number (maps to `NumeroDeCuenta`).
	AccountNumber string `json:"account_number" jsonschema:"title=Account Number"`
	// Sum of all line totals (i.e. taxes not included) (calculated, maps to `SubTotal`).
	Subtotal num.Amount `json:"subtotal" jsonschema:"title=Subtotal" jsonschema_extras:"calculated=true"`
	// Grand total after taxes have been applied (calculated, maps to `Total`).
	Total num.Amount `json:"total" jsonschema:"title=Total" jsonschema_extras:"calculated=true"`
	// List of fuel purchases made with the customer's e-wallets (maps to `Conceptos`).
	Lines []*FuelAccountLine `json:"lines" jsonschema:"title=Lines"`
}

type FuelAccountItem struct {
	// Type of fuel (one of `c_ClaveTipoCombustible` codes, maps to `TipoCombustible`).
	Type cbc.Code `json:"type" jsonschema:"title=Type"`
	// Reference unit of measure used in the price and the quantity (maps to `Unidad`).
	Unit org.Unit `json:"unit,omitempty" jsonschema:"title=Unit"`
	// Name of the fuel (maps to `NombreCombustible`).
	Name string `json:"name" jsonschema:"title=Name"`
	// Base price of a single unit of the fuel without taxes (maps to `ValorUnitario`).
	Price num.Amount `json:"price" jsonschema:"title=Price"`
}

type FuelAccountLine struct {
	// Index of the line starting from 1 (calculated)
	Index int `json:"i" jsonschema:"title=Index" jsonschema_extras:"calculated=true"`
	// Identifier of the e-wallet used to make the purchase (maps to `Identificador`).
	EWalletID cbc.Code `json:"e_wallet_id" jsonschema:"title=E-wallet Identifier"`
	// Date and time of the purchase (maps to `Fecha`).
	PurchaseDateTime cal.DateTime `json:"purchase_date_time" jsonschema:"title=Purchase Date and Time"`
	// Tax Identity Code of the fuel's vendor (maps to `Rfc`)
	VendorTaxCode cbc.Code `json:"vendor_tax_code" jsonschema:"title=Vendor's Tax Identity Code"`
	// Code of the service station where the purchase was made (maps to `ClaveEstacion`).
	ServiceStationCode cbc.Code `json:"service_station_code" jsonschema:"title=Service Station Code"`
	// Amount of fuel units purchased (maps to `Cantidad`)
	Quantity num.Amount `json:"quantity" jsonschema:"title=Quantity"`
	// Details of the fuel purchased.
	Item *FuelAccountItem `json:"item" jsonschema:"title=Item"`
	// Identifier of the purchase (maps to `FolioOperacion`).
	PurchaseCode cbc.Code `json:"purchase_code" jsonschema:"title=Purchase Code"`
	// Result of quantity multiplied by the unit price (maps to `Importe`).
	Total num.Amount `json:"total" jsonschema:"title=Total" jsonschema_extras:"calculated=true"`
	// Map of taxes applied to the purchase (maps to `Traslados`).
	Taxes []*FuelAccountTax `json:"taxes" jsonschema:"title=Taxes"`
}

type FuelAccountTax struct {
	// Category that identifies the tax ("VAT" or "IEPS", maps to `Impuesto`)
	Category cbc.Code `json:"cat" jsonschema:"title=Category"`
	// Percent applicable to the line total (tasa) to use instead of Rate (maps to `TasaoCuota`)
	Percent *num.Percentage `json:"percent,omitempty" jsonschema:"title=Percent"`
	// Rate is a fixed fee to apply to the line quantity (cuota) (maps to `TasaOCuota`)
	Rate *num.Amount `json:"rate,omitempty" jsonschema:"title=Rate"`
	// Total amount of the tax once the percent or rate has been applied (maps to `Importe`).
	Amount num.Amount `json:"amount" jsonschema:"title=Amount" jsonschema_extras:"calculated=true"`
}