@deuriib/dgii-ecf 0.5.1 → 0.6.0

package/dist/index.d.cts

@@ -30,6 +30,7 @@ declare enum Endpoint {
     InquiryStatus = "consultaestado/api/Consultas/Estado",
     AllTrackingEcf = "ConsultaTrackIds/api/TrackIds/Consulta",
     Directory = "consultadirectorio/api/consultas/obtenerdirectorioporrnc",
+    DirectoryList = "consultadirectorio/api/consultas/listado",
     Void = "anulacionrangos/api/operaciones/anularrango"
 }
 /** Endpoints used when talking to a buyer's Sender↔Receiver host. */
@@ -39,6 +40,20 @@ declare enum SenderReceiverEndpoint {
     SendInvoice = "fe/recepcion/api/ecf",
     CommercialApproval = "fe/aprobacioncomercial/api/ecf"
 }
+/** Service-status endpoints. They carry no environment segment. */
+declare enum StatusEndpoint {
+    Services = "api/estatusservicios/obtenerestatus",
+    MaintenanceWindows = "api/estatusservicios/obtenerventanasmantenimiento",
+    Check = "api/estatusservicios/verificarestado"
+}
+/** Numeric `ambiente` codes accepted by the status service. */
+declare enum StatusEnvironment {
+    PreCertification = 1,
+    Production = 2,
+    Certification = 3
+}
+/** Build an absolute status-service URL (no environment segment). */
+declare const buildStatusUrl: (endpoint: StatusEndpoint, baseUrl?: string) => string;
 /** Build an absolute DGII URL: `${baseUrl}/${environment}/${endpoint}`. */
 declare const buildUrl: (environment: Environment, endpoint: Endpoint, baseUrl?: string) => string;
 /** Build an absolute Sender↔Receiver URL against a buyer host. */
@@ -76,10 +91,17 @@ interface TrackingStatusResponse {
     mensajes?: Mensaje[];
 }
 type InquiryStatusCode = 0 | 1 | 2;
-type InquiryStatus = 'No encontrado' | 'Aceptado' | 'Rechazado';
+/**
+ * eNCF inquiry states. "Aceptado Condicional" is observable for an E32 below
+ * RD$250,000 even though the tracking service reports it with a different
+ * code, so it belongs in the union.
+ */
+type InquiryStatus = 'No encontrado' | 'Aceptado' | 'Rechazado' | 'Aceptado Condicional';
 interface InquiryStatusResponse {
     codigo: InquiryStatusCode;
     estado: InquiryStatus;
+    /** `true` when the e-NCF sequence is already consumed. */
+    secuenciaUtilizada?: boolean;
     rncEmisor?: string;
     ncfElectronico?: string;
     montoTotal?: number;
@@ -106,9 +128,18 @@ interface InvoiceResponse {
     /** Tolerated array form used by the RFCE and status endpoints. */
     mensajes?: Mensaje[];
 }
+/**
+ * Documented states of an RFCE reception. DGII is not consistent about casing
+ * between services (the tracking service reports "Aceptado Condicional"), so
+ * `estado` stays a `string` and these constants are the documented values.
+ */
+declare const SUMMARY_ACCEPTED = "Aceptado";
+declare const SUMMARY_CONDITIONAL_ACCEPTED = "Aceptado condicional";
+declare const SUMMARY_REJECTED = "Rechazado";
 interface InvoiceSummaryResponse {
     codigo: number;
-    estado: 'Aceptado' | 'Rechazado' | 'Aceptado Condicional';
+    /** One of the `SUMMARY_*` constants, compared case-insensitively. */
+    estado: string;
     mensajes?: Mensaje[];
     encf: string;
     secuenciaUtilizada: boolean;
@@ -138,7 +169,34 @@ interface VoidNCFResponse {
     rnc: string;
     codigo: string;
     nombre: string;
-    mensajes: string[];
+    /** DGII returns objects on some services and bare strings on others. */
+    mensajes: Mensaje[];
+}
+/** Operational state reported by the DGII status service. */
+type ServiceAvailability = 'Disponible' | 'No Disponible';
+/** One entry of `getServiceStatus` (`estatusservicios/obtenerestatus`). */
+interface ServiceStatusEntry {
+    servicio: string;
+    estatus: ServiceAvailability;
+    ambiente: string;
+}
+/** One maintenance window of `getMaintenanceWindows`. */
+interface MaintenanceWindow {
+    ambiente: string;
+    horaInicio: string;
+    horaFin: string;
+    dias: string[];
+}
+/** Result of `checkServiceAvailability` (`estatusservicios/verificarestado`). */
+interface ServiceAvailabilityResponse {
+    estado: ServiceAvailability;
+}
+/** Outcome of a direct ACECF delivery to a buyer host (Emisor↔Receptor). */
+interface B2BCommercialApprovalResponse {
+    /** HTTP status returned by the buyer host: 200 satisfactory, 400 unsatisfactory. */
+    status: 200 | 400;
+    /** `true` for HTTP 200, `false` for HTTP 400. */
+    accepted: boolean;
 }
 
 type DgiiErrorCode = 'INVALID_XML' | 'CERTIFICATE' | 'SIGNING' | 'HTTP' | 'AUTH' | 'TIMEOUT' | 'CIRCUIT_OPEN' | 'IDEMPOTENCY' | 'VALIDATION' | 'UNKNOWN';
@@ -279,6 +337,8 @@ interface RequestOptions {
     resource?: string;
     /** Skip the auth hooks (used by the authentication round-trip itself). */
     skipAuthHooks?: boolean;
+    /** Do not attach the bearer token (used by the status service). */
+    omitAuth?: boolean;
 }
 /** Thin HTTP client over the native `fetch`, wrapped in resilience policies. */
 declare class HttpClient {
@@ -370,6 +430,14 @@ declare const validateXMLCertificate: (xml: string) => XmlCertificateValidation;
  * Values that are not plain decimals (e.g. `1.0e3`) are returned unchanged.
  */
 declare const roundHalfUpToCents: (value: string) => string;
+/**
+ * Drop empty leaves and the containers they leave behind.
+ *
+ * DGII forbids empty tags: any element without a value must be omitted
+ * entirely instead of being serialized as `<Tag/>` or `<Tag></Tag>`. An object
+ * that only carries `_attributes` is *not* empty — it still renders an element.
+ */
+declare const pruneEmptyValues: (input: unknown) => unknown;
 /**
  * Converts between the DGII XML documents and the "compact" JSON shape used by
  * `xml-js` (a dict key is an element, an array is a repeated element, and
@@ -418,6 +486,66 @@ declare const compareDecimal: (a: string, b: string) => number;
  * cannot drift from what is actually being transmitted.
  */
 declare const resolveReceptionRoute: (signedXml: string) => Result<ReceptionRoute, DgiiError>;
+/**
+ * Whether a signed document may be delivered directly to a buyer host.
+ *
+ * DGII excludes E32 below RD$250,000 (only the RFCE summary applies) plus
+ * E41, E43, E45, E46 and E47. E31, E33, E34, E44 and an E32 at or above the
+ * threshold can go peer-to-peer.
+ */
+declare const checkB2BApplicability: (signedXml: string) => Result<void, DgiiError>;
+
+/** Message returned when a submission with the same key is already in flight. */
+declare const PENDING_SUBMISSION_MESSAGE = "A submission with this key is already pending; call reconcileSubmission() before retrying";
+/** Outcome of reconciling a pending submission against DGII. */
+interface ReconciliationResult {
+    /** DGII's answer for the e-NCF. */
+    inquiry: InquiryStatusResponse;
+    /** `true` when DGII already has a record of the document. */
+    delivered: boolean;
+    /** `true` when the e-NCF sequence may be reused. */
+    canReuseSequence: boolean;
+    /** `true` when the pending marker was cleared and a retry is safe. */
+    cleared: boolean;
+}
+/**
+ * Whether a rejected e-NCF sequence may be reused.
+ *
+ * DGII sets `secuenciaUtilizada` to `true` when the sequence is consumed and
+ * `false` when the rejection leaves it reusable: invalid certificate or
+ * signature, invalid XML, non-delegated signer, unauthorized or expired e-NCF,
+ * non-electronic issuer, unknown or inactive RNC.
+ *
+ * An absent flag is treated as "not reusable" — the conservative answer.
+ */
+declare const canReuseSequence: (response: {
+    secuenciaUtilizada?: boolean | null;
+}) => boolean;
+
+declare const SCHEMA_DIR: string;
+/** Schemas DGII publishes but that do not compile, with the reason. */
+declare const UNAVAILABLE_SCHEMAS: Record<string, string>;
+/** One schema violation, with the element DGII would complain about. */
+interface SchemaViolation {
+    path: string;
+    message: string;
+}
+interface ValidationOptions {
+    /**
+     * `xmllint` binary to use. Defaults to `DGII_XMLLINT_BIN` or `xmllint` on
+     * `PATH`. There is no bundled engine: validation shells out.
+     */
+    bin?: string;
+}
+/**
+ * Validate a DGII document against its bundled XML Schema.
+ *
+ * Requires `xmllint` (libxml2-utils) on `PATH`, or `DGII_XMLLINT_BIN` pointing
+ * at it. A missing binary is an error — never a silent pass.
+ */
+declare const validateDocument: (xml: string, options?: ValidationOptions) => Result<SchemaViolation[], DgiiError>;
+/** One-line summary of the first violations, for an error message. */
+declare const formatViolations: (violations: readonly SchemaViolation[]) => string;
 
 /** First 6 chars of the `<SignatureValue>` (DGII security code). */
 declare const getCodeSixDigitfromSignature: (signedXml: string) => Result<string, DgiiError>;
@@ -456,6 +584,20 @@ interface EcfOptions {
     tokenRefreshSkewMs?: number;
     /** Injectable clock (epoch milliseconds); useful for tests. */
     now?: () => number;
+    /** API key for the `statusecf` service (`Authorization: Apikey …`). */
+    statusApiKey?: string;
+    /**
+     * Reject a direct buyer-host delivery for the e-CF types DGII excludes
+     * (E32 below RD$250,000, E41, E43, E45, E46, E47). Defaults to `true`.
+     */
+    enforceB2BRules?: boolean;
+    /**
+     * Validate a general e-CF against its bundled XML Schema before sending.
+     * Requires `xmllint` (or `DGII_XMLLINT_BIN`). Defaults to `false`.
+     */
+    validateBeforeSend?: boolean;
+    /** `xmllint` binary used by `validateBeforeSend`. */
+    xmllintBin?: string;
 }
 /**
  * DGII e-CF client. Every method returns a `Result` — no thrown domain errors.
@@ -468,6 +610,10 @@ declare class ECF {
     private readonly inFlight;
     private readonly tokenRefreshSkewMs;
     private readonly now;
+    private readonly statusApiKey;
+    private readonly enforceB2BRules;
+    private readonly validateBeforeSend;
+    private readonly xmllintBin;
     private tokenExpiresAt;
     private refreshPromise;
     constructor(credentials: P12ReaderData, environment?: Environment, options?: EcfOptions);
@@ -494,6 +640,28 @@ declare class ECF {
     private reauthenticate;
     /** Authenticate against DGII (or a buyer host) and store the bearer token. */
     authenticate(buyerHost?: string): Promise<Result<AuthToken, DgiiError>>;
+    /**
+     * Query the operational status of every DGII service.
+     *
+     * The status host takes an API key instead of a bearer token, so this call
+     * neither needs `authenticate()` nor triggers a token refresh.
+     */
+    getServiceStatus(): Promise<Result<ServiceStatusEntry[], DgiiError>>;
+    /** Scheduled maintenance windows, one entry per environment. */
+    getMaintenanceWindows(): Promise<Result<MaintenanceWindow[], DgiiError>>;
+    /** Whether an environment is currently inside a maintenance window. */
+    checkServiceAvailability(ambiente: StatusEnvironment): Promise<Result<ServiceAvailabilityResponse, DgiiError>>;
+    private statusRequest;
+    /**
+     * Resolve what happened to a submission whose idempotency marker is pending.
+     *
+     * Queries DGII by e-NCF. When DGII has no record of the document the marker
+     * is cleared, because re-submitting cannot double-issue. When DGII does have
+     * a record the marker stays in place — it is the lock that prevents a second
+     * submission of a document that already exists — and `delivered` tells the
+     * caller to stop retrying.
+     */
+    reconcileSubmission(signedXml: string): Promise<Result<ReconciliationResult, DgiiError>>;
     private getSeed;
     private getAuthToken;
     /**
@@ -517,6 +685,8 @@ declare class ECF {
     trackStatuses(rncEmisor: string, encf: string): Promise<Result<SummaryTrackingStatusResponse[], DgiiError>>;
     /** Normalizes DGII's inconsistent (array | single object) directory payload. */
     getCustomerDirectory(rnc: string): Promise<Result<ServiceDirectoryResponse[] | undefined, DgiiError>>;
+    /** General directory listing — every receiver that publishes service URLs. */
+    getDirectoryListing(): Promise<Result<ServiceDirectoryResponse[], DgiiError>>;
     /** RFCE inquiry — DGII production only. */
     getSummaryInvoiceInquiry(rnc: string, encf: string, codSeguridad: string): Promise<Result<InquiryInvoiceSummary, DgiiError>>;
     /**
@@ -524,6 +694,7 @@ declare class ECF {
      * keyed on `RNC + eNCF + SHA-256(signed XML)`.
      */
     sendCommercialApproval(signedXml: string, fileName: string): Promise<Result<CommercialApprovalResponse, DgiiError>>;
+    sendCommercialApproval(signedXml: string, fileName: string, buyerHost: string): Promise<Result<B2BCommercialApprovalResponse, DgiiError>>;
     /**
      * Submit a signed range-voiding request (ANECF). Idempotent like
      * submissions, keyed on `RNC + RangoNCF + SHA-256(signed XML)`.
@@ -531,4 +702,4 @@ declare class ECF {
     voidENCF(signedXml: string, fileName: string): Promise<Result<VoidNCFResponse, DgiiError>>;
 }
 
-export { type AuthToken, BaseUrl, type BaseUrlKey, CONSUMPTION_SUMMARY_THRESHOLD, type CertificateInfo, type CommercialApprovalResponse, type DgiiDocumentType, DgiiError, type DgiiErrorCode, type DgiiErrorContext, type DgiiErrorOptions, type DgiiResult, ECF, ECF_TYPE_CODES, type EcfOptions, type EcfTypeCode, Endpoint, Environment, type GeneralReceptionRoute, HttpClient, type HttpClientOptions, type IdempotencyStore, InMemoryIdempotencyStore, type InMemoryIdempotencyStoreOptions, type InquiryInvoiceSummary, type InquiryStatus, type InquiryStatusCode, type InquiryStatusResponse, type InvoiceResponse, type InvoiceSummaryResponse, type Mensaje, P12Reader, type P12ReaderData, type ReceptionRoute, type RequestOptions, type ResilienceOptions, type ResiliencePolicies, SenderReceiverEndpoint, type ServiceDirectoryResponse, Signature, type SummaryReceptionRoute, type SummaryTrackingStatusResponse, type TrackStatusCode, TrackStatusEnum, type TrackingStatusResponse, Transformer, type VoidNCFResponse, type XmlCertificateValidation, buildSenderReceiverUrl, buildUrl, compareDecimal, convertECF32ToRFCE, createResiliencePolicies, defaultResilienceOptions, extractDgiiErrorMessage, generateEcfQRCodeURL, generateFcQRCodeURL, getCodeSixDigitfromSignature, getCurrentFormattedDate, getCurrentFormattedDateTime, getXmlFromBodyResponse, isEcfTypeCode, isRetryableError, isRetryableStatus, resolveReceptionRoute, roundHalfUpToCents, toDgiiError, validateXMLCertificate };
+export { type AuthToken, type B2BCommercialApprovalResponse, BaseUrl, type BaseUrlKey, CONSUMPTION_SUMMARY_THRESHOLD, type CertificateInfo, type CommercialApprovalResponse, type DgiiDocumentType, DgiiError, type DgiiErrorCode, type DgiiErrorContext, type DgiiErrorOptions, type DgiiResult, ECF, ECF_TYPE_CODES, type EcfOptions, type EcfTypeCode, Endpoint, Environment, type GeneralReceptionRoute, HttpClient, type HttpClientOptions, type IdempotencyStore, InMemoryIdempotencyStore, type InMemoryIdempotencyStoreOptions, type InquiryInvoiceSummary, type InquiryStatus, type InquiryStatusCode, type InquiryStatusResponse, type InvoiceResponse, type InvoiceSummaryResponse, type MaintenanceWindow, type Mensaje, P12Reader, type P12ReaderData, PENDING_SUBMISSION_MESSAGE, type ReceptionRoute, type ReconciliationResult, type RequestOptions, type ResilienceOptions, type ResiliencePolicies, SCHEMA_DIR, SUMMARY_ACCEPTED, SUMMARY_CONDITIONAL_ACCEPTED, SUMMARY_REJECTED, type SchemaViolation, SenderReceiverEndpoint, type ServiceAvailability, type ServiceAvailabilityResponse, type ServiceDirectoryResponse, type ServiceStatusEntry, Signature, StatusEndpoint, StatusEnvironment, type SummaryReceptionRoute, type SummaryTrackingStatusResponse, type TrackStatusCode, TrackStatusEnum, type TrackingStatusResponse, Transformer, UNAVAILABLE_SCHEMAS, type ValidationOptions, type VoidNCFResponse, type XmlCertificateValidation, buildSenderReceiverUrl, buildStatusUrl, buildUrl, canReuseSequence, checkB2BApplicability, compareDecimal, convertECF32ToRFCE, createResiliencePolicies, defaultResilienceOptions, extractDgiiErrorMessage, formatViolations, generateEcfQRCodeURL, generateFcQRCodeURL, getCodeSixDigitfromSignature, getCurrentFormattedDate, getCurrentFormattedDateTime, getXmlFromBodyResponse, isEcfTypeCode, isRetryableError, isRetryableStatus, pruneEmptyValues, resolveReceptionRoute, roundHalfUpToCents, toDgiiError, validateDocument, validateXMLCertificate };

package/dist/index.d.ts

@@ -30,6 +30,7 @@ declare enum Endpoint {
     InquiryStatus = "consultaestado/api/Consultas/Estado",
     AllTrackingEcf = "ConsultaTrackIds/api/TrackIds/Consulta",
     Directory = "consultadirectorio/api/consultas/obtenerdirectorioporrnc",
+    DirectoryList = "consultadirectorio/api/consultas/listado",
     Void = "anulacionrangos/api/operaciones/anularrango"
 }
 /** Endpoints used when talking to a buyer's Sender↔Receiver host. */
@@ -39,6 +40,20 @@ declare enum SenderReceiverEndpoint {
     SendInvoice = "fe/recepcion/api/ecf",
     CommercialApproval = "fe/aprobacioncomercial/api/ecf"
 }
+/** Service-status endpoints. They carry no environment segment. */
+declare enum StatusEndpoint {
+    Services = "api/estatusservicios/obtenerestatus",
+    MaintenanceWindows = "api/estatusservicios/obtenerventanasmantenimiento",
+    Check = "api/estatusservicios/verificarestado"
+}
+/** Numeric `ambiente` codes accepted by the status service. */
+declare enum StatusEnvironment {
+    PreCertification = 1,
+    Production = 2,
+    Certification = 3
+}
+/** Build an absolute status-service URL (no environment segment). */
+declare const buildStatusUrl: (endpoint: StatusEndpoint, baseUrl?: string) => string;
 /** Build an absolute DGII URL: `${baseUrl}/${environment}/${endpoint}`. */
 declare const buildUrl: (environment: Environment, endpoint: Endpoint, baseUrl?: string) => string;
 /** Build an absolute Sender↔Receiver URL against a buyer host. */
@@ -76,10 +91,17 @@ interface TrackingStatusResponse {
     mensajes?: Mensaje[];
 }
 type InquiryStatusCode = 0 | 1 | 2;
-type InquiryStatus = 'No encontrado' | 'Aceptado' | 'Rechazado';
+/**
+ * eNCF inquiry states. "Aceptado Condicional" is observable for an E32 below
+ * RD$250,000 even though the tracking service reports it with a different
+ * code, so it belongs in the union.
+ */
+type InquiryStatus = 'No encontrado' | 'Aceptado' | 'Rechazado' | 'Aceptado Condicional';
 interface InquiryStatusResponse {
     codigo: InquiryStatusCode;
     estado: InquiryStatus;
+    /** `true` when the e-NCF sequence is already consumed. */
+    secuenciaUtilizada?: boolean;
     rncEmisor?: string;
     ncfElectronico?: string;
     montoTotal?: number;
@@ -106,9 +128,18 @@ interface InvoiceResponse {
     /** Tolerated array form used by the RFCE and status endpoints. */
     mensajes?: Mensaje[];
 }
+/**
+ * Documented states of an RFCE reception. DGII is not consistent about casing
+ * between services (the tracking service reports "Aceptado Condicional"), so
+ * `estado` stays a `string` and these constants are the documented values.
+ */
+declare const SUMMARY_ACCEPTED = "Aceptado";
+declare const SUMMARY_CONDITIONAL_ACCEPTED = "Aceptado condicional";
+declare const SUMMARY_REJECTED = "Rechazado";
 interface InvoiceSummaryResponse {
     codigo: number;
-    estado: 'Aceptado' | 'Rechazado' | 'Aceptado Condicional';
+    /** One of the `SUMMARY_*` constants, compared case-insensitively. */
+    estado: string;
     mensajes?: Mensaje[];
     encf: string;
     secuenciaUtilizada: boolean;
@@ -138,7 +169,34 @@ interface VoidNCFResponse {
     rnc: string;
     codigo: string;
     nombre: string;
-    mensajes: string[];
+    /** DGII returns objects on some services and bare strings on others. */
+    mensajes: Mensaje[];
+}
+/** Operational state reported by the DGII status service. */
+type ServiceAvailability = 'Disponible' | 'No Disponible';
+/** One entry of `getServiceStatus` (`estatusservicios/obtenerestatus`). */
+interface ServiceStatusEntry {
+    servicio: string;
+    estatus: ServiceAvailability;
+    ambiente: string;
+}
+/** One maintenance window of `getMaintenanceWindows`. */
+interface MaintenanceWindow {
+    ambiente: string;
+    horaInicio: string;
+    horaFin: string;
+    dias: string[];
+}
+/** Result of `checkServiceAvailability` (`estatusservicios/verificarestado`). */
+interface ServiceAvailabilityResponse {
+    estado: ServiceAvailability;
+}
+/** Outcome of a direct ACECF delivery to a buyer host (Emisor↔Receptor). */
+interface B2BCommercialApprovalResponse {
+    /** HTTP status returned by the buyer host: 200 satisfactory, 400 unsatisfactory. */
+    status: 200 | 400;
+    /** `true` for HTTP 200, `false` for HTTP 400. */
+    accepted: boolean;
 }
 
 type DgiiErrorCode = 'INVALID_XML' | 'CERTIFICATE' | 'SIGNING' | 'HTTP' | 'AUTH' | 'TIMEOUT' | 'CIRCUIT_OPEN' | 'IDEMPOTENCY' | 'VALIDATION' | 'UNKNOWN';
@@ -279,6 +337,8 @@ interface RequestOptions {
     resource?: string;
     /** Skip the auth hooks (used by the authentication round-trip itself). */
     skipAuthHooks?: boolean;
+    /** Do not attach the bearer token (used by the status service). */
+    omitAuth?: boolean;
 }
 /** Thin HTTP client over the native `fetch`, wrapped in resilience policies. */
 declare class HttpClient {
@@ -370,6 +430,14 @@ declare const validateXMLCertificate: (xml: string) => XmlCertificateValidation;
  * Values that are not plain decimals (e.g. `1.0e3`) are returned unchanged.
  */
 declare const roundHalfUpToCents: (value: string) => string;
+/**
+ * Drop empty leaves and the containers they leave behind.
+ *
+ * DGII forbids empty tags: any element without a value must be omitted
+ * entirely instead of being serialized as `<Tag/>` or `<Tag></Tag>`. An object
+ * that only carries `_attributes` is *not* empty — it still renders an element.
+ */
+declare const pruneEmptyValues: (input: unknown) => unknown;
 /**
  * Converts between the DGII XML documents and the "compact" JSON shape used by
  * `xml-js` (a dict key is an element, an array is a repeated element, and
@@ -418,6 +486,66 @@ declare const compareDecimal: (a: string, b: string) => number;
  * cannot drift from what is actually being transmitted.
  */
 declare const resolveReceptionRoute: (signedXml: string) => Result<ReceptionRoute, DgiiError>;
+/**
+ * Whether a signed document may be delivered directly to a buyer host.
+ *
+ * DGII excludes E32 below RD$250,000 (only the RFCE summary applies) plus
+ * E41, E43, E45, E46 and E47. E31, E33, E34, E44 and an E32 at or above the
+ * threshold can go peer-to-peer.
+ */
+declare const checkB2BApplicability: (signedXml: string) => Result<void, DgiiError>;
+
+/** Message returned when a submission with the same key is already in flight. */
+declare const PENDING_SUBMISSION_MESSAGE = "A submission with this key is already pending; call reconcileSubmission() before retrying";
+/** Outcome of reconciling a pending submission against DGII. */
+interface ReconciliationResult {
+    /** DGII's answer for the e-NCF. */
+    inquiry: InquiryStatusResponse;
+    /** `true` when DGII already has a record of the document. */
+    delivered: boolean;
+    /** `true` when the e-NCF sequence may be reused. */
+    canReuseSequence: boolean;
+    /** `true` when the pending marker was cleared and a retry is safe. */
+    cleared: boolean;
+}
+/**
+ * Whether a rejected e-NCF sequence may be reused.
+ *
+ * DGII sets `secuenciaUtilizada` to `true` when the sequence is consumed and
+ * `false` when the rejection leaves it reusable: invalid certificate or
+ * signature, invalid XML, non-delegated signer, unauthorized or expired e-NCF,
+ * non-electronic issuer, unknown or inactive RNC.
+ *
+ * An absent flag is treated as "not reusable" — the conservative answer.
+ */
+declare const canReuseSequence: (response: {
+    secuenciaUtilizada?: boolean | null;
+}) => boolean;
+
+declare const SCHEMA_DIR: string;
+/** Schemas DGII publishes but that do not compile, with the reason. */
+declare const UNAVAILABLE_SCHEMAS: Record<string, string>;
+/** One schema violation, with the element DGII would complain about. */
+interface SchemaViolation {
+    path: string;
+    message: string;
+}
+interface ValidationOptions {
+    /**
+     * `xmllint` binary to use. Defaults to `DGII_XMLLINT_BIN` or `xmllint` on
+     * `PATH`. There is no bundled engine: validation shells out.
+     */
+    bin?: string;
+}
+/**
+ * Validate a DGII document against its bundled XML Schema.
+ *
+ * Requires `xmllint` (libxml2-utils) on `PATH`, or `DGII_XMLLINT_BIN` pointing
+ * at it. A missing binary is an error — never a silent pass.
+ */
+declare const validateDocument: (xml: string, options?: ValidationOptions) => Result<SchemaViolation[], DgiiError>;
+/** One-line summary of the first violations, for an error message. */
+declare const formatViolations: (violations: readonly SchemaViolation[]) => string;
 
 /** First 6 chars of the `<SignatureValue>` (DGII security code). */
 declare const getCodeSixDigitfromSignature: (signedXml: string) => Result<string, DgiiError>;
@@ -456,6 +584,20 @@ interface EcfOptions {
     tokenRefreshSkewMs?: number;
     /** Injectable clock (epoch milliseconds); useful for tests. */
     now?: () => number;
+    /** API key for the `statusecf` service (`Authorization: Apikey …`). */
+    statusApiKey?: string;
+    /**
+     * Reject a direct buyer-host delivery for the e-CF types DGII excludes
+     * (E32 below RD$250,000, E41, E43, E45, E46, E47). Defaults to `true`.
+     */
+    enforceB2BRules?: boolean;
+    /**
+     * Validate a general e-CF against its bundled XML Schema before sending.
+     * Requires `xmllint` (or `DGII_XMLLINT_BIN`). Defaults to `false`.
+     */
+    validateBeforeSend?: boolean;
+    /** `xmllint` binary used by `validateBeforeSend`. */
+    xmllintBin?: string;
 }
 /**
  * DGII e-CF client. Every method returns a `Result` — no thrown domain errors.
@@ -468,6 +610,10 @@ declare class ECF {
     private readonly inFlight;
     private readonly tokenRefreshSkewMs;
     private readonly now;
+    private readonly statusApiKey;
+    private readonly enforceB2BRules;
+    private readonly validateBeforeSend;
+    private readonly xmllintBin;
     private tokenExpiresAt;
     private refreshPromise;
     constructor(credentials: P12ReaderData, environment?: Environment, options?: EcfOptions);
@@ -494,6 +640,28 @@ declare class ECF {
     private reauthenticate;
     /** Authenticate against DGII (or a buyer host) and store the bearer token. */
     authenticate(buyerHost?: string): Promise<Result<AuthToken, DgiiError>>;
+    /**
+     * Query the operational status of every DGII service.
+     *
+     * The status host takes an API key instead of a bearer token, so this call
+     * neither needs `authenticate()` nor triggers a token refresh.
+     */
+    getServiceStatus(): Promise<Result<ServiceStatusEntry[], DgiiError>>;
+    /** Scheduled maintenance windows, one entry per environment. */
+    getMaintenanceWindows(): Promise<Result<MaintenanceWindow[], DgiiError>>;
+    /** Whether an environment is currently inside a maintenance window. */
+    checkServiceAvailability(ambiente: StatusEnvironment): Promise<Result<ServiceAvailabilityResponse, DgiiError>>;
+    private statusRequest;
+    /**
+     * Resolve what happened to a submission whose idempotency marker is pending.
+     *
+     * Queries DGII by e-NCF. When DGII has no record of the document the marker
+     * is cleared, because re-submitting cannot double-issue. When DGII does have
+     * a record the marker stays in place — it is the lock that prevents a second
+     * submission of a document that already exists — and `delivered` tells the
+     * caller to stop retrying.
+     */
+    reconcileSubmission(signedXml: string): Promise<Result<ReconciliationResult, DgiiError>>;
     private getSeed;
     private getAuthToken;
     /**
@@ -517,6 +685,8 @@ declare class ECF {
     trackStatuses(rncEmisor: string, encf: string): Promise<Result<SummaryTrackingStatusResponse[], DgiiError>>;
     /** Normalizes DGII's inconsistent (array | single object) directory payload. */
     getCustomerDirectory(rnc: string): Promise<Result<ServiceDirectoryResponse[] | undefined, DgiiError>>;
+    /** General directory listing — every receiver that publishes service URLs. */
+    getDirectoryListing(): Promise<Result<ServiceDirectoryResponse[], DgiiError>>;
     /** RFCE inquiry — DGII production only. */
     getSummaryInvoiceInquiry(rnc: string, encf: string, codSeguridad: string): Promise<Result<InquiryInvoiceSummary, DgiiError>>;
     /**
@@ -524,6 +694,7 @@ declare class ECF {
      * keyed on `RNC + eNCF + SHA-256(signed XML)`.
      */
     sendCommercialApproval(signedXml: string, fileName: string): Promise<Result<CommercialApprovalResponse, DgiiError>>;
+    sendCommercialApproval(signedXml: string, fileName: string, buyerHost: string): Promise<Result<B2BCommercialApprovalResponse, DgiiError>>;
     /**
      * Submit a signed range-voiding request (ANECF). Idempotent like
      * submissions, keyed on `RNC + RangoNCF + SHA-256(signed XML)`.
@@ -531,4 +702,4 @@ declare class ECF {
     voidENCF(signedXml: string, fileName: string): Promise<Result<VoidNCFResponse, DgiiError>>;
 }
 
-export { type AuthToken, BaseUrl, type BaseUrlKey, CONSUMPTION_SUMMARY_THRESHOLD, type CertificateInfo, type CommercialApprovalResponse, type DgiiDocumentType, DgiiError, type DgiiErrorCode, type DgiiErrorContext, type DgiiErrorOptions, type DgiiResult, ECF, ECF_TYPE_CODES, type EcfOptions, type EcfTypeCode, Endpoint, Environment, type GeneralReceptionRoute, HttpClient, type HttpClientOptions, type IdempotencyStore, InMemoryIdempotencyStore, type InMemoryIdempotencyStoreOptions, type InquiryInvoiceSummary, type InquiryStatus, type InquiryStatusCode, type InquiryStatusResponse, type InvoiceResponse, type InvoiceSummaryResponse, type Mensaje, P12Reader, type P12ReaderData, type ReceptionRoute, type RequestOptions, type ResilienceOptions, type ResiliencePolicies, SenderReceiverEndpoint, type ServiceDirectoryResponse, Signature, type SummaryReceptionRoute, type SummaryTrackingStatusResponse, type TrackStatusCode, TrackStatusEnum, type TrackingStatusResponse, Transformer, type VoidNCFResponse, type XmlCertificateValidation, buildSenderReceiverUrl, buildUrl, compareDecimal, convertECF32ToRFCE, createResiliencePolicies, defaultResilienceOptions, extractDgiiErrorMessage, generateEcfQRCodeURL, generateFcQRCodeURL, getCodeSixDigitfromSignature, getCurrentFormattedDate, getCurrentFormattedDateTime, getXmlFromBodyResponse, isEcfTypeCode, isRetryableError, isRetryableStatus, resolveReceptionRoute, roundHalfUpToCents, toDgiiError, validateXMLCertificate };
+export { type AuthToken, type B2BCommercialApprovalResponse, BaseUrl, type BaseUrlKey, CONSUMPTION_SUMMARY_THRESHOLD, type CertificateInfo, type CommercialApprovalResponse, type DgiiDocumentType, DgiiError, type DgiiErrorCode, type DgiiErrorContext, type DgiiErrorOptions, type DgiiResult, ECF, ECF_TYPE_CODES, type EcfOptions, type EcfTypeCode, Endpoint, Environment, type GeneralReceptionRoute, HttpClient, type HttpClientOptions, type IdempotencyStore, InMemoryIdempotencyStore, type InMemoryIdempotencyStoreOptions, type InquiryInvoiceSummary, type InquiryStatus, type InquiryStatusCode, type InquiryStatusResponse, type InvoiceResponse, type InvoiceSummaryResponse, type MaintenanceWindow, type Mensaje, P12Reader, type P12ReaderData, PENDING_SUBMISSION_MESSAGE, type ReceptionRoute, type ReconciliationResult, type RequestOptions, type ResilienceOptions, type ResiliencePolicies, SCHEMA_DIR, SUMMARY_ACCEPTED, SUMMARY_CONDITIONAL_ACCEPTED, SUMMARY_REJECTED, type SchemaViolation, SenderReceiverEndpoint, type ServiceAvailability, type ServiceAvailabilityResponse, type ServiceDirectoryResponse, type ServiceStatusEntry, Signature, StatusEndpoint, StatusEnvironment, type SummaryReceptionRoute, type SummaryTrackingStatusResponse, type TrackStatusCode, TrackStatusEnum, type TrackingStatusResponse, Transformer, UNAVAILABLE_SCHEMAS, type ValidationOptions, type VoidNCFResponse, type XmlCertificateValidation, buildSenderReceiverUrl, buildStatusUrl, buildUrl, canReuseSequence, checkB2BApplicability, compareDecimal, convertECF32ToRFCE, createResiliencePolicies, defaultResilienceOptions, extractDgiiErrorMessage, formatViolations, generateEcfQRCodeURL, generateFcQRCodeURL, getCodeSixDigitfromSignature, getCurrentFormattedDate, getCurrentFormattedDateTime, getXmlFromBodyResponse, isEcfTypeCode, isRetryableError, isRetryableStatus, pruneEmptyValues, resolveReceptionRoute, roundHalfUpToCents, toDgiiError, validateDocument, validateXMLCertificate };