Enum FiscalError 

#[non_exhaustive]
pub enum FiscalError {
    InvalidTaxData(String),
    UnsupportedIcmsCst(String),
    UnsupportedIcmsCsosn(String),
    MissingRequiredField {
        field: String,
    },
    InvalidGtin(String),
    XmlGeneration(String),
    XmlParsing(String),
    SefazRejection {
        code: String,
        message: String,
    },
    Certificate(String),
    InvalidStateCode(String),
    Contingency(String),
    InvalidTxt(String),
    WrongDocument(String),
    Network(String),
    ConfigValidation(String),
}

The primary error type returned by all public functions in fiscal-core, fiscal-crypto, and fiscal-sefaz.

All variants are #[non_exhaustive] so new error cases can be added in future releases without breaking downstream match arms.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidTaxData(String)

A tax data field contains an illegal value (e.g. malformed CNPJ, wrong field length, invalid access-key format).

UnsupportedIcmsCst(String)

An ICMS CST code is not recognised by the current tax computation module.

UnsupportedIcmsCsosn(String)

An ICMS CSOSN code is not recognised by the current tax computation module.

MissingRequiredField

A required XML field is absent. The field member names the missing tag.

Fields

field: String

Name of the required XML tag or parameter that was absent.

InvalidGtin(String)

A GTIN barcode value is malformed or has an invalid check digit.

XmlGeneration(String)

An error occurred while building or serialising an XML document.

XmlParsing(String)

An error occurred while parsing an XML document.

SefazRejection

SEFAZ returned a rejection status code for a submitted document or event.

Fields

code: String

SEFAZ status code (cStat), e.g. "301".

message: String

Human-readable rejection message (xMotivo).

Certificate(String)

An error occurred while loading, parsing, or using a PKCS#12 certificate.

InvalidStateCode(String)

A two-letter state abbreviation (UF) or IBGE numeric code was not found in the lookup table.

Contingency(String)

An error occurred while activating, loading, or applying contingency mode.

InvalidTxt(String)

A TXT document is structurally invalid or references an unsupported layout.

WrongDocument(String)

The supplied document is not of the expected type (e.g. not a valid NFe TXT header).

Network(String)

An HTTP or network-level error occurred during SEFAZ communication.

ConfigValidation(String)

A configuration JSON is invalid or missing required fields.

Trait Implementations

impl Debug for FiscalError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for FiscalError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for FiscalError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for FiscalError

fn eq(&self, other: &FiscalError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FiscalError

impl StructuralPartialEq for FiscalError