Struct Contingency 

#[non_exhaustive]
pub struct Contingency {
    pub contingency_type: Option<ContingencyType>,
    pub reason: Option<String>,
    pub activated_at: Option<String>,
    pub timestamp: u64,
}

Contingency manager for NF-e emission.

Manages activation and deactivation of contingency mode, used when the primary SEFAZ authorizer is unavailable. Supports SVC-AN, SVC-RS, and offline contingency types.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

contingency_type: Option<ContingencyType>

The active contingency type, or None when in normal mode.

reason: Option<String>

Justification reason for entering contingency (15-256 chars).

activated_at: Option<String>

ISO-8601 timestamp when contingency was activated.

timestamp: u64

Unix timestamp (seconds since epoch) of activation.

Implementations

impl Contingency

pub fn new() -> Self

Create a new contingency manager with no active contingency (normal mode).

pub fn activate( &mut self, contingency_type: ContingencyType, reason: &str, ) -> Result<(), FiscalError>

Activate contingency mode with the given type and justification reason.

The reason is trimmed and must be between 15 and 256 UTF-8 characters (inclusive). On success, the contingency is activated with the current UTC timestamp.

Errors

Returns FiscalError::Contingency if the trimmed reason is shorter than 15 characters or longer than 256 characters.

pub fn deactivate(&mut self)

Deactivate contingency mode, resetting to normal emission.

pub fn load(json: &str) -> Result<Self, FiscalError>

Load contingency state from a JSON string.

Expected JSON format:

{"motive":"reason","timestamp":1480700623,"type":"SVCAN","tpEmis":6}

Errors

Returns FiscalError::Contingency if the JSON cannot be parsed or contains an unrecognized contingency type.

pub fn emission_type(&self) -> u8

Get the emission type code for the current contingency state.

Returns 1 (normal) if no contingency is active, or 6 (SVC-AN), 7 (SVC-RS), or 9 (offline) when contingency is active.

pub fn emission_type_enum(&self) -> EmissionType

Get the EmissionType enum for the current contingency state.

Trait Implementations

impl Clone for Contingency

fn clone(&self) -> Contingency

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Contingency

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

Formats the value using the given formatter.

impl Default for Contingency

fn default() -> Self

Returns the “default value” for a type.