@nodecfdi/sat-estado-cfdi

Consulta el estado de un cfdi en el webservice del SAT

Usage no npm install needed!

<script type="module">
  import nodecfdiSatEstadoCfdi from 'https://cdn.skypack.dev/@nodecfdi/sat-estado-cfdi';
</script>

README

nodecfdi/sat-estado-cfdi

Source Code Latest Version Software License Discord

Consulta el estado de un CFDI en el webservice del SAT

Esta librería contiene objetos de ayuda para consumir el Servicio de Consulta de CFDI del SAT. La documentación del proyecto está en español porque ese es el lenguaje de los usuarios que la utilizarán. Esta librería está inspirada en: https://github.com/phpcfdi/sat-estado-cfdi/

Servicio de Consulta de CFDI del SAT:

Instalación

npm i @nodecfdi/sat-estado-cfdi --save

o

yarn add @nodecfdi/sat-estado-cfdi

Ejemplo básico de uso

import { ConsumerClientInterface, Consumer } from '@nodecfdi/sat-estado-cfdi';

//el cliente debe implementar ConsumerClientInterface
const client = Client();
const consumer = new Consumer(client);

// para clientes síncronos el consumer debe tener la opción de hacer llamadas síncronas
const cfdiStatus = consumer.execute('...expression');

//si tu cliente es asíncrono usa executeAsync
const cfdiStatusAsync = await consumer.executeAsync('...expression');

if (cfdiStatus.getCancellable().notCancellable()) {
    console.log('CFDI no es cancelable');
}

Expresiones (input)

El consumidor requiere una expresión para poder consultar. La expresión es el texto que viene en el código QR de la representación impresa de un CFDI.

Las expresiones son diferentes para CFDI 3.2, CFDI 3.3 y RET 1.0. Tienen reglas específicas de formato y de la información que debe contener.

Si no cuentas con la expresión, te recomiendo usar la librería nodecfdi/cfdi-expresiones.

Estados (salida)

Después de consumir el servicio, se responderá con un objeto CfdiStatus que agrupa de los cuatro estados.

No compares directamente los valores de los estados, en su lugar utiliza los métodos is*, por ejemplo $response->document()->isCancelled().

Posibles estados:

  • CodigoEstatus: query(): QueryStatus.

    • found: Si el estado inicia con S - .
    • notFound: en cualquier otro caso.

  • Estado: document(): DocumentStatus.

    • active: Si el estado reportó Vigente.
    • cancelled: Si el estado reportó Cancelado.
    • notFound: en cualquier otro caso.

  • EsCancelable: cancellable(): CancellableStatus.

    • cancellableByDirectCall: Si el estado reportó Cancelable sin aceptación.
    • cancellableByApproval: Si el estado reportó Cancelable con aceptación.
    • notCancellable: en cualquier otro caso.

  • EstatusCancelacion: cancellation(): CancellationStatus.

    • cancelledByDirectCall: Si el estado reportó Cancelado sin aceptación.
    • cancelledByApproval: Si el estado reportó Cancelado con aceptación.
    • cancelledByExpiration: Si el estado reportó Plazo vencido.
    • pending: Si el estado reportó En proceso.
    • disapproved: Si el estado reportó Solicitud rechazada.
    • undefined: en cualquier otro caso.

  • ValidacionEFOS: efos(): EfosStatus.

    • included: Si el estado no reportó 200.
    • excluded: Si el estado reportó 200.

Estados mutuamente excluyentes:

CodigoEstatus Estado EsCancelable EstatusCancelacion Explicación
N - ... * * * El SAT no sabe del CFDI con la expresión dada
S - ... Cancelado * Plazo vencido Cancelado por plazo vencido
S - ... Cancelado * Cancelado con aceptación Cancelado con aceptación del receptor
S - ... Cancelado * Cancelado sin aceptación No fue requerido preguntarle al receptor y se canceló
S - ... Vigente No cancelable * No se puede cancelar
S - ... Vigente Cancelable sin aceptación * Se puede cancelar, pero no se ha realizado la cancelación
S - ... Vigente Cancelable con aceptación (ninguno) Se puede cancelar, pero no se ha realizado la solicitud
S - ... Vigente Cancelable con aceptación En proceso Se hizo la solicitud y está en espera de respuesta
S - ... Vigente Cancelable con aceptación Solicitud rechazada Se hizo la solicitud y fue rechazada

Cuando tienes un CFDI en estado Cancelable con aceptación y mandas a hacer la cancelación entonces su estado de cancelación cambiaría a En proceso.

El receptor puede aceptar la cancelación (Cancelado con aceptación) o rechazarla (Solicitud rechazada).

Si es la primera vez que se hace la solicitud, el receptor tiene 72 horas para aceptarla o rechazarla, si no lo hace entonces automáticamente será cancelada (Plazo vencido).

Podrías volver a enviar la solicitud de cancelación por segunda vez aun cuando la solicitud fue previamente rechazada.

En ese caso, el receptor puede aceptar o rechazar la cancelación, pero ya no aplicará un lapzo de 72 horas. Por lo anterior entonces podrías tener el CFDI en estado de cancelación en proceso indefinidamente. Incluso, que la cancelación suceda meses después de lo esperado.