> ## Documentation Index > Fetch the complete documentation index at: https://docs.facture.ar/llms.txt > Use this file to discover all available pages before exploring further. # Anular una factura con nota de crédito > Encola la nota de crédito que anula por el total una factura A, B, C o M autorizada por ARCA (A→NC A, B→NC B, C→NC C, M→NC M): mismo receptor, ítems, importes y moneda, asociada a la factura (`CbtesAsoc`) y con fecha de hoy. No cuenta contra el límite de facturas del plan. Es asíncrono: seguí el `batchId` con `GET /invoices/batches/{batchId}`. Una factura se anula una sola vez: mientras su nota está en la cola, en ARCA o ya autorizada, otro pedido responde `409`. Mandá un header `Idempotency-Key` para poder reintentar sin pedir dos veces (ver la guía de idempotencia). ## OpenAPI ````yaml /openapi.json post /invoices/{invoiceId}/credit-note openapi: 3.1.0 info: title: Facturear API description: >- API para emitir facturas electrónicas de ARCA (Argentina) desde tu sistema: facturas, notas de crédito y débito, lotes, PDF y XML, envío por email, borradores desde documentos, webhooks y reportes. Autenticación con API Key en el header x-api-key: la key de testing opera en homologación y la de producción emite comprobantes reales. version: 1.0.0 contact: name: Facturear Support email: support@facture.ar url: https://facture.ar license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://www.facture.ar/api description: Servidor de producción security: - apiKey: [] tags: - name: CUITs description: CUITs emisores, sus defaults, puntos de venta y diseño - name: Facturas description: Emitir, listar y consultar facturas, su PDF y XML, y enviarlas por email - name: Lotes description: 'El resultado de cada emisión: toda factura se procesa en un lote' - name: Borradores description: >- Facturas propuestas desde documentos, planillas o datos, para revisar y emitir - name: Plantillas description: Cómo se lee y se factura cada tipo de documento, y facturas recurrentes - name: Importar desde ARCA description: Traer a Facturear los comprobantes que ARCA ya autorizó - name: Webhooks description: Notificaciones a tu sistema cuando pasa algo con tus facturas - name: Reportes description: Libro IVA Ventas - name: Utilidades description: Parámetros de ARCA paths: /invoices/{invoiceId}/credit-note: post: tags: - Facturas summary: Anular una factura con nota de crédito description: >- Encola la nota de crédito que anula por el total una factura A, B, C o M autorizada por ARCA (A→NC A, B→NC B, C→NC C, M→NC M): mismo receptor, ítems, importes y moneda, asociada a la factura (`CbtesAsoc`) y con fecha de hoy. No cuenta contra el límite de facturas del plan. Es asíncrono: seguí el `batchId` con `GET /invoices/batches/{batchId}`. Una factura se anula una sola vez: mientras su nota está en la cola, en ARCA o ya autorizada, otro pedido responde `409`. Mandá un header `Idempotency-Key` para poder reintentar sin pedir dos veces (ver la guía de idempotencia). parameters: - name: invoiceId in: path description: ID de la factura a anular required: true schema: type: string - $ref: '#/components/parameters/IdempotencyKey' responses: '202': description: >- Nota de crédito encolada. Un reenvío con el mismo `Idempotency-Key` devuelve esta misma respuesta. headers: Idempotent-Replayed: $ref: '#/components/headers/IdempotentReplayed' content: application/json: schema: type: object properties: status: type: string enum: - processing batchId: type: string description: Lote a seguir con GET /invoices/batches/{batchId} voids: type: string description: La factura que se anula example: Factura C 0003-00000012 '400': description: >- La factura no se puede anular: no está autorizada por ARCA, no es A, B, C o M, o ya es una nota de crédito de anulación. También si el `Idempotency-Key` es inválido. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: API key faltante o inválida content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Factura no encontrada content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- La factura ya fue anulada (`creditNoteId`), su nota de crédito está en la cola o en ARCA (`batchId` para seguirla), o hay una solicitud en curso con este `Idempotency-Key`. content: application/json: schema: type: object properties: error: type: string creditNoteId: type: string description: ID de la nota de crédito que ya anuló la factura batchId: type: string description: Lote de la nota de crédito que está en curso code: type: string '422': $ref: '#/components/responses/IdempotencyKeyReused' components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false description: >- Clave que elegís vos (recomendado: un UUID nuevo por cada factura o lote). Si reenviás la misma solicitud con la misma clave —por un timeout, un error de red o un 5xx— recibís la respuesta original (mismo `batchId`, header `Idempotent-Replayed: true`) en vez de una factura nueva. Para una factura distinta, o después de que ARCA rechazó la anterior en forma definitiva, usá una clave nueva. Entre 1 y 255 caracteres ASCII imprimibles; se guarda 7 días. En un lote, el ítem `i` queda identificado como `:`. schema: type: string minLength: 1 maxLength: 255 example: 6f1c2b0e-8a43-4c5e-9d2a-3b7f1e0c9a11 headers: IdempotentReplayed: description: >- `true` cuando la respuesta es la guardada de una solicitud anterior con el mismo `Idempotency-Key`: no se encoló nada nuevo. schema: type: string enum: - 'true' schemas: Error: type: object description: >- Error de la API. Los errores de autenticación (401), validación (400), CUIT inexistente (404), conflicto (409) e internos (500) vienen como application/problem+json (RFC 9457) con code, message y resolution. Otros errores vienen como JSON con error y, a veces, details y code. En los dos casos está el campo error. required: - error properties: error: type: string description: Mensaje de error code: type: string description: >- Código estable: unauthorized, invalid_request, cuit_not_found, conflict, internal_error, o códigos propios como SUBSCRIPTION_LIMIT_EXCEEDED message: type: string description: Qué pasó (problem+json) resolution: type: string description: Qué hacer para resolverlo (problem+json) type: type: string format: uri description: URI del tipo de problema (problem+json) title: type: string description: Título corto del problema (problem+json) status: type: integer description: Código HTTP (problem+json) detail: type: string description: Igual que message (problem+json) details: description: 'Detalle del error: un texto, o la lista de errores de validación' responses: IdempotencyKeyReused: description: >- Este `Idempotency-Key` ya se usó con otra solicitud: otro cuerpo u otro endpoint (code `IDEMPOTENCY_KEY_REUSED`). Usá una clave nueva para una factura distinta. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- API Key para autenticación. Formato: test_sk_xxx para testing, prod_sk_xxx para producción. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.