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 all contingency types defined in the NF-e specification: SVC-AN, SVC-RS, EPEC, FS-DA, FS-IA, and offline.

JSON persistence

The state can be serialized to / deserialized from a compact JSON string using to_json and load, matching the PHP Contingency::__toString() format:

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

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-255 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 is_active(&self) -> bool

Returns true when a contingency mode is currently active.

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 255 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 255 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 (matching PHP Contingency):

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

Accepts all contingency type strings: SVCAN, SVC-AN, SVCRS, SVC-RS, EPEC, FSDA, FS-DA, FSIA, FS-IA, OFFLINE, and their lowercase equivalents.

Errors

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

pub fn to_json(&self) -> String

Serialize the contingency state to a JSON string.

Produces the same format as the PHP Contingency::__toString():

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

When deactivated, produces:

{"motive":"","timestamp":0,"type":"","tpEmis":1}

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 the corresponding tpEmis code: 2 (FS-IA), 4 (EPEC), 5 (FS-DA), 6 (SVC-AN), 7 (SVC-RS), 9 (offline).

pub fn emission_type_enum(&self) -> EmissionType

Get the EmissionType enum for the current contingency state.

pub fn check_web_service_availability( &self, model: InvoiceModel, ) -> Result<(), FiscalError>

Check whether the current contingency mode has a dedicated web service.

Only SVC-AN and SVC-RS have their own SEFAZ web services. Other types (EPEC, FS-DA, FS-IA, offline) do not have their own web services for NF-e authorization and will return an error if used with sefazAutorizacao.

Errors

Returns FiscalError::Contingency if:

• The document is model 65 (NFC-e) and an SVC contingency is active (NFC-e does not support SVC-AN/SVC-RS).
• The active contingency type does not have a dedicated web service (EPEC, FS-DA, FS-IA, offline).

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.

impl<'de> Deserialize<'de> for Contingency

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Contingency

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

Formats the value using the given formatter.

impl Serialize for Contingency

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.