DOCUMENTACION API COMERCIAL

Requisitos

Este tutorial asume que ya tienes los siguientes elementos:

• Una cuenta configurada con la modalidad de API activada. Si aún no tienes tu cuenta configurada, consulta la Guía de Inicio Rápido.
• Tus credenciales para consumir la API. Para más información sobre cómo obtener y utilizar tus credenciales en el encabezado de tu petición, consulta la sección de Autenticación.
• Un CFDI previamente emitido con la API. Si aún no has generado un CFDI, consulta el tutorial para timbrar tu comprobante.
  
  Un CFDI tiene que estar registrado ante el SAT antes de poderlo cancelar en el entorno de producción. Es recomendable esperar al menos 5 minutos entre la petición de timbrado y la petición de cancelación.

Puedes realizar una petición de cancelación de CFDI en los siguientes casos:

• Si tienes una cuenta gratis: Puedes cancelar hasta 5 CFDI con validez fiscal dentro de los 30 días después de la creación de la cuenta gratis y antes de pasar al esquema de prepago. Además, puedes cancelar una cantidad ilimitada de CFDI sin validez fiscal para probar la integración de la API con el entorno de prueba.
• Si tienes saldo en tu cuenta: Puedes cancelar la cantidad de CFDI que requieras mientras tengas saldo en tu cuenta para consumir la API, tanto en el entorno de prueba como en el entorno de producción. No se cobra la cancelación por comprobante. Para consultar tu saldo disponible, puedes realizar una petición al endpoint POST https://api.enlacefiscal.com/v6/obtenerSaldo.

Petición    POST cancelarCfdi

En este tutorial se muestra cómo hacer una petición API de cancelación de un CFDI timbrado cancelable en el entorno de producción. Si quieres cancelar un CFDI emitido en el entorno de prueba, solo necesitas cambiar el valor del parámetro modo a debug.

curl "https://api.enlacefiscal.com/v6/probarConexion"
--request "POST"
--header "Content-Type:application/json"
--header "x-api-key:<X-API-KEY>"
--user "<USUARIO>:<TOKEN>"
--data '{
    {
  "Solicitud": {
    "modo": "produccion",
    "rfc": "AAA010101AAA",
    "accion": "cancelarCfdi",
    "CFDi": {
      "serie": "B",
      "folio": 798,
      "justificacion": "Error en descripción de producto"
      }
    }
  }	
}

Respuesta

Una petición de cancelación puede tener múltiples respuestas dependiendo del escenario del esquema de cancelación:

• CFDI no cancelable:
• CFDI cancelable sin aceptación: La cancelación del CFDI se produce de manera instantánea, siempre y cuando el servicio del SAT se encuentre disponible. Si el servicio del SAT no se encuentra disponible, puedes programar la cancelación del CFDI via la API para el futuro.
• CFDI cancelable con aceptación: La cancelación puede tardar hasta 3 días hábiles porque requiere la aceptación del receptor del CFDI para ser cancelada. En caso de que el receptor no responda a la solicitud de cancelación dentro de los 3 días hábiles, el CFDI se cancela por plazo vencido.

La respuesta que recibes de nuestra API está en formato JSON. El estado de cancelación se encuentra en la respuesta de la petición.

{
    "AckEnlaceFiscal": {
        "numeroReferencia": 1008,
        "estatusDocumento": "aceptado",
        "fechaMensaje": "2018-08-17 12:27:53",
        "version": "1.0",
        "estatusCancelacion": "Cancelado",
        "fechaCancelacion": "2018-08-17T12:27:52",
        "uuid": "4E14B6AE-4F94-4227-AF3F-3BD743C5D207",
        "folio": 1,
        "serie": "FAAPI",
        "infoCancelacion": [
            {
                "fechaSolicitud": null,
                "justificacion": "Error en el monto",
                "fechaLimiteAceptacion": null,
                "estatus": "Cancelado sin aceptación",
                "fechaUltimaConsultaSat": null,
                "fechaCancelacion": "2018-08-17T12:27:52",
                "selloSat": "SLGmjdlsKy7WEM4i4SkMrrKl+1Wi8jDA7g4BFSGYwNPjL4WDSXuVF5ISPOGywufSaPDwx8Tt+dw=="
            }
        ]
    }
}

Endpoint

POST https://api.enlacefiscal.com/v6/consultaDeCancelacionesConAceptacion

Elementos de la petición

La siguiente tabla describe los parámetros en formato JSON que debes enviar dentro de tu petición.

Ejemplo de petición

El siguiente es un código de ejemplo de la petición para consultar los CFDI cancelables pendientes de aceptación.

curl "https://api.enlacefiscal.com/v6/consultaDeCancelacionesConAceptacion"
--request "POST"
--header "Content-Type:application/json"
--header "x-api-key:<X-API-KEY>"
--user "<USUARIO>:<TOKEN>"
--data '{
}

Elementos de la respuesta

Los elementos que componen la respuesta son los siguientes:

Ejemplo de respuesta

El siguiente código muestra un ejemplo de respuesta a la petición    POST consultaDeCancelacionesConAceptacion.

{
    "AckEnlaceFiscal": {
        "numeroReferencia": 1586,
        "estatusDocumento": "aceptado",
        "fechaMensaje": "2018-08-17 18:04:02",
        "version": "1.0",
        "totalCancelacionesConAceptacion": 2,
        "cancelacionesConAceptacion": [
            {
                "fechaSolicitud": "2018-08-17 12:15:29",
                "tipoComprobante": "Factura",
                "serie": "FA",
                "folioInterno": 325,
                "folioFiscalUUID": "8743bff7-8b45-4947-97bb-4a25daaa",
                "fechaEmision": "2018-08-15 15:58:13",
                "rfcReceptor": "AAA010101AAA",
                "nombreReceptor": "Empresa Demo S.A. de C.V.",
                "monto": "5800.00",
                "justificacion": "Error en el monto",
                "fechaLimiteAceptacion": "2018-08-22 23:59:59",                
                "estatus": "En proceso",
                "fechaUltimaConsultaSat": "2018-08-17 12:25:00",
                "fechaCancelacion": null,
                "selloSat": null
            },
            {
                "fechaSolicitud": "2018-08-17 12:47:48",
                "tipoComprobante": "Recibo de Honorarios",
                "serie": "RH",
                "folioInterno": 52,
                "folioFiscalUUID": "3e6344ea-7e02-4d6b-9720-7974fd92",
                "fechaEmision": "2018-08-01 13:14:23",
                "rfcReceptor": "AAA010101AAA",
                "nombreReceptor": "Empresa Demo S.A. de C.V.",
                "monto": "12000.00",
                "justificacion": "La fecha de emisión es incorrecta",
                "fechaLimiteAceptacion": "2018-08-22 23:59:59",
                "estatus": "Cancelado aceptado",
                "fechaUltimaConsultaSat": "2018-08-17 12:50:00",
                "fechaCancelacion": "2018-08-17 12:49:00",
                "selloSat": "SLGmjdlsKy7WEM4i4SkMrrKl+1Wi8jDA7g4BFSGYwNPjL4WDSXuVF5ISPOGywufSaPDwx8Tt+dw=="
            }
        ]
    }
}