openapi: 3.0.3
info:
  title: Mammoth e-CF API
  version: 0.1.0
  description: |
    API de facturación electrónica (e-CF) para la DGII de República Dominicana. Genera, firma, envía y da seguimiento a comprobantes fiscales electrónicos.

    **Estado:** en pruebas. Los comprobantes no tienen validez fiscal hasta completar la validación con el ambiente de pre-certificación de la DGII.

    Cada empresa tiene su propia llave y sus datos aislados. El emisor de cada comprobante es siempre la empresa dueña de la llave.
servers:
  - url: https://ecf.mammoth-corp.com/api
    description: Producción del servicio (ambiente de pruebas de la DGII por ahora)
security:
  - llaveEmpresa: []
tags:
  - name: Comprobantes
  - name: Certificado y secuencias
  - name: Recibidos y anulaciones
  - name: Cuenta y llaves
paths:
  /comprobantes:
    post:
      tags: [Comprobantes]
      summary: Emitir un comprobante
      description: |
        Valida los datos, reserva el siguiente e-NCF, calcula los totales, genera el XML, lo firma y lo deja en cola para enviarlo a la DGII. Responde 202: el envío ocurre después.

        Los precios van **sin ITBIS**. Si los datos no cumplen el esquema de la DGII se responde 422 y **no se consume ningún e-NCF**. Con la misma `idempotency_key` una petición repetida devuelve el mismo comprobante.

        Las facturas de consumo (tipo 32) menores de RD$250,000 se envían a la DGII como resumen (RFCE); el comprobante completo se conserva.
      requestBody:
        required: true
        content:
          application/json:
            schema: { $ref: '#/components/schemas/ComprobanteEntrada' }
            examples:
              creditoFiscal:
                summary: Crédito fiscal (31)
                value:
                  idempotency_key: orden-5521
                  tipo: 31
                  tipoPago: 1
                  emisor: { razonSocial: MI EMPRESA SRL, direccion: 'Av. Winston Churchill 10, Santo Domingo' }
                  comprador: { rnc: '101672919', razonSocial: Cliente SRL }
                  formasPago: [{ forma: 1, monto: 118 }]
                  items: [{ nombre: Consultoría, tipo: 2, cantidad: 1, precio: 100, itbis: 18 }]
              consumo:
                summary: Factura de consumo (32)
                value:
                  tipo: 32
                  tipoPago: 1
                  emisor: { razonSocial: MI NEGOCIO SRL, direccion: 'Calle 1, Santiago' }
                  items: [{ nombre: Café, tipo: 1, cantidad: 2, precio: 100, itbis: 18, propinaLegal: true }]
      responses:
        '202':
          description: Comprobante creado y en cola (o el mismo comprobante si la `idempotency_key` ya existía).
          content:
            application/json:
              schema: { $ref: '#/components/schemas/ComprobanteCreado' }
        '401': { $ref: '#/components/responses/NoAutorizado' }
        '409': { $ref: '#/components/responses/Conflicto' }
        '422': { $ref: '#/components/responses/Invalido' }
    get:
      tags: [Comprobantes]
      summary: Listar comprobantes
      description: Más recientes primero. Para la página siguiente, usa el valor `siguiente` como `antes`.
      parameters:
        - { name: estado, in: query, schema: { $ref: '#/components/schemas/Estado' } }
        - { name: limite, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 } }
        - { name: antes, in: query, description: Fecha de creación (ISO) desde la cual continuar., schema: { type: string, format: date-time } }
      responses:
        '200':
          description: Lista
          content:
            application/json:
              schema:
                type: object
                properties:
                  comprobantes: { type: array, items: { $ref: '#/components/schemas/ComprobanteResumen' } }
                  siguiente: { type: string, format: date-time, nullable: true }
        '401': { $ref: '#/components/responses/NoAutorizado' }
  /comprobantes/{id}:
    get:
      tags: [Comprobantes]
      summary: Consultar un comprobante
      description: Acepta el id o el e-NCF (por ejemplo `E310000000001`).
      parameters: [{ $ref: '#/components/parameters/Id' }]
      responses:
        '200':
          description: Estado del comprobante
          content:
            application/json:
              schema: { $ref: '#/components/schemas/ComprobanteDetalle' }
        '401': { $ref: '#/components/responses/NoAutorizado' }
        '404': { $ref: '#/components/responses/NoEncontrado' }
  /comprobantes/{id}/xml:
    get:
      tags: [Comprobantes]
      summary: Descargar el XML firmado
      description: "El e-CF completo, firmado. Conserva este documento: es el comprobante."
      parameters: [{ $ref: '#/components/parameters/Id' }]
      responses:
        '200': { description: XML firmado, content: { application/xml: { schema: { type: string } } } }
        '404': { $ref: '#/components/responses/NoEncontrado' }
  /comprobantes/{id}/resumen:
    get:
      tags: [Comprobantes]
      summary: Descargar el resumen (RFCE) firmado
      description: Solo existe para facturas de consumo (32) menores de RD$250,000.
      parameters: [{ $ref: '#/components/parameters/Id' }]
      responses:
        '200': { description: XML del resumen firmado, content: { application/xml: { schema: { type: string } } } }
        '404': { $ref: '#/components/responses/NoEncontrado' }
  /comprobantes/{id}/impresion:
    get:
      tags: [Comprobantes]
      summary: Representación impresa
      description: "Página HTML lista para imprimir (A4 por defecto, o ticket de 80 mm con `formato=ticket`) con el orden de datos que exige la DGII, el código QR de consulta y el código de seguridad. Para guardarla en PDF, imprímela desde el navegador. Si el comprobante aún no fue aceptado por la DGII, la página lo advierte (no sirve para crédito fiscal). El servicio entrega el HTML como texto (`text/plain`): guárdalo como archivo `.html` o muéstralo desde tu sistema; el panel ya lo abre listo para imprimir."
      parameters:
        - { $ref: '#/components/parameters/Id' }
        - { name: formato, in: query, schema: { type: string, enum: [a4, ticket], default: a4 } }
      responses:
        '200': { description: Página HTML, content: { text/html: { schema: { type: string } } } }
        '404': { $ref: '#/components/responses/NoEncontrado' }
  /recibidos:
    get:
      tags: [Recibidos y anulaciones]
      summary: Comprobantes que le enviaron a tu empresa
      description: "Los e-CF que otros emisores (o la DGII) enviaron a tu empresa a través de sus direcciones de recepción, con el resultado del acuse de recibo, las respuestas comerciales que tú ya diste (`aprobaciones_emitidas`) y las que tus clientes dieron a tus comprobantes (`aprobaciones`)."
      parameters:
        - { name: limite, in: query, schema: { type: integer, minimum: 1, maximum: 100, default: 25 } }
      responses:
        '200':
          description: Lista
          content:
            application/json:
              schema:
                type: object
                properties:
                  recibidos: { type: array, items: { type: object, properties: { id: { type: string }, emisor_rnc: { type: string }, encf: { type: string }, tipo: { type: string }, monto_total: { type: number }, recibido: { type: boolean }, motivo_no_recibido: { type: integer, nullable: true, description: "1 error de especificación, 2 firma digital, 3 envío duplicado, 4 el RNC comprador no corresponde" }, detalle: { type: string, nullable: true }, recibido_en: { type: string, format: date-time } } } }
                  aprobaciones_emitidas: { type: array, items: { type: object } }
                  aprobaciones: { type: array, items: { type: object } }
        '401': { $ref: '#/components/responses/NoAutorizado' }
  /recibidos/{id}/aprobacion:
    post:
      tags: [Recibidos y anulaciones]
      summary: Aceptar o rechazar comercialmente un comprobante recibido
      description: "Genera la aprobación (o el rechazo) comercial, la firma con el certificado de tu empresa y la envía a la DGII. Se puede responder una sola vez por comprobante. Si la DGII no responde, queda `pendiente` y el motor reintenta solo (hasta 8 veces)."
      parameters:
        - { name: id, in: path, required: true, schema: { type: string }, description: Id del e-CF recibido (de `GET /recibidos`). }
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [estado]
              properties:
                estado: { type: string, enum: [aceptado, rechazado] }
                motivo: { type: string, maxLength: 250, description: "Obligatorio al rechazar." }
      responses:
        '201': { description: La DGII registró la respuesta }
        '202': { description: Guardada y firmada; pendiente de envío o reintento }
        '400': { description: Estado inválido o rechazo sin motivo, content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } } }
        '404': { $ref: '#/components/responses/NoEncontrado' }
        '409': { $ref: '#/components/responses/Conflicto' }
  /anulaciones:
    get:
      tags: [Recibidos y anulaciones]
      summary: Historial de anulaciones de rangos
      responses:
        '200': { description: Lista, content: { application/json: { schema: { type: object, properties: { anulaciones: { type: array, items: { type: object } } } } } } }
    post:
      tags: [Recibidos y anulaciones]
      summary: Anular rangos de e-NCF que nunca se usaron
      description: "Solo para números que **nunca se usaron**. Un comprobante ya emitido o enviado se anula con una nota de crédito (código de modificación 1), no con esta llamada. El motor firma el documento de anulación (ANECF), lo envía a la DGII y, **solo si la DGII confirma**, marca esos números como usados en tus secuencias (si el rango queda en el medio de una secuencia, esta se parte en dos)."
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [rangos]
              properties:
                rangos:
                  type: array
                  items: { type: object, required: [tipo, desde, hasta], properties: { tipo: { type: integer, enum: [31, 32, 33, 34, 41, 43, 44, 45, 46, 47] }, desde: { type: integer, minimum: 1 }, hasta: { type: integer } } }
      responses:
        '201': { description: Anulados en la DGII y en tus secuencias }
        '200': { description: "La DGII rechazó la anulación o no la confirmó por completo (`estado` rechazada o error); tus secuencias no se modificaron." }
        '409': { $ref: '#/components/responses/Conflicto' }
        '422': { $ref: '#/components/responses/Invalido' }
        '502': { description: No se pudo contactar a la DGII; queda registrada con estado error., content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } } }
  /certificado:
    put:
      tags: [Certificado y secuencias]
      summary: Cargar el certificado digital
      description: Se guarda cifrado. Reemplaza al certificado activo anterior. Un certificado vencido o con contraseña incorrecta se rechaza (422). Debe ser el certificado del representante registrado (o delegado) ante la DGII; si su titular no coincide con el RNC de la empresa se devuelve una advertencia informativa.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [p12_base64, password]
              properties:
                p12_base64: { type: string, description: 'Contenido del archivo .p12 / .pfx en base64.' }
                password: { type: string }
      responses:
        '200':
          description: Certificado guardado
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok: { type: boolean }
                  titular_id: { type: string, nullable: true }
                  valido_hasta: { type: string, format: date-time }
                  advertencias: { type: array, items: { type: string } }
        '401': { $ref: '#/components/responses/NoAutorizado' }
        '422': { $ref: '#/components/responses/Invalido' }
  /secuencias:
    post:
      tags: [Certificado y secuencias]
      summary: Registrar un rango de e-NCF autorizado
      description: '`vence` es obligatorio para los tipos 31 y 33. Se rechaza un rango que se solape con otro registrado.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [tipo, desde, hasta]
              properties:
                tipo: { type: integer, enum: [31, 32, 33, 34, 41, 43, 44, 45, 46, 47] }
                desde: { type: integer, minimum: 1 }
                hasta: { type: integer, maximum: 9999999999 }
                vence: { type: string, format: date, description: AAAA-MM-DD }
      responses:
        '201': { description: Secuencia registrada }
        '400': { description: Rango o tipo inválido, content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } } }
        '401': { $ref: '#/components/responses/NoAutorizado' }
        '409': { $ref: '#/components/responses/Conflicto' }
  /me:
    get:
      tags: [Cuenta y llaves]
      summary: Resumen de la empresa
      description: Datos de la empresa, certificado, secuencias (con cuántos números quedan) y comprobantes de los últimos 30 días por estado.
      responses:
        '200':
          description: Resumen
          content:
            application/json:
              schema:
                type: object
                properties:
                  empresa: { type: object, properties: { id: { type: string }, nombre: { type: string }, rnc: { type: string }, ambiente: { type: string, enum: [testecf, certecf, ecf] } } }
                  certificado: { type: object, nullable: true, properties: { titular_id: { type: string, nullable: true }, valido_desde: { type: string, format: date-time }, valido_hasta: { type: string, format: date-time }, advertencia: { type: string, nullable: true } } }
                  secuencias: { type: array, items: { type: object, properties: { tipo: { type: integer }, desde: { type: integer }, hasta: { type: integer }, siguiente: { type: integer }, restantes: { type: integer }, vence: { type: string, nullable: true }, activo: { type: boolean } } } }
                  ultimos_30_dias: { type: object, additionalProperties: { type: integer } }
                  contingencia: { type: object, properties: { activa: { type: boolean }, desde: { type: string, nullable: true }, motivo: { type: string, nullable: true }, automatica: { type: boolean }, pendientes_de_envio: { type: integer }, limite_mas_urgente: { type: string, nullable: true } } }
        '401': { $ref: '#/components/responses/NoAutorizado' }
  /contingencia:
    post:
      tags: [Cuenta y llaves]
      summary: Activar o terminar la contingencia
      description: Activa o termina a mano el modo de contingencia (sin conexión con la DGII). El motor también la detecta y la termina solo. Mientras dura, los comprobantes se generan y firman igual y se envían al volver la conexión, en un máximo de 72 horas; su representación impresa lleva la leyenda de contingencia.
      requestBody:
        required: true
        content:
          application/json:
            schema: { type: object, required: [activa], properties: { activa: { type: boolean }, motivo: { type: string, maxLength: 200 } } }
      responses:
        '200': { description: Hecho, content: { application/json: { schema: { type: object, properties: { modo_contingencia: { type: boolean } } } } } }
        '401': { $ref: '#/components/responses/NoAutorizado' }
  /webhook:
    put:
      tags: [Cuenta y llaves]
      summary: Registrar el webhook
      description: >-
        Registra (o cambia) la dirección https que recibe un POST firmado cuando un comprobante queda aceptado, rechazado o con error. Devuelve el secreto de la firma una sola vez. Cabeceras del aviso, x-mammoth-event y x-mammoth-signature (t=segundos,v1=HMAC-SHA256 hexadecimal de t.cuerpo).
      requestBody:
        required: true
        content:
          application/json:
            schema: { type: object, required: [url], properties: { url: { type: string, example: 'https://miapp.do/hooks/ecf' } } }
      responses:
        '200': { description: Registrado, content: { application/json: { schema: { type: object, properties: { url: { type: string }, secreto: { type: string }, aviso: { type: string } } } } } }
        '400': { description: La dirección no es https o no es un nombre público. }
        '401': { $ref: '#/components/responses/NoAutorizado' }
    get:
      tags: [Cuenta y llaves]
      summary: Ver el webhook y los últimos avisos
      responses:
        '200': { description: Dirección y últimos 20 avisos con su estado de entrega }
        '401': { $ref: '#/components/responses/NoAutorizado' }
    delete:
      tags: [Cuenta y llaves]
      summary: Quitar el webhook
      responses:
        '200': { description: Quitado }
        '401': { $ref: '#/components/responses/NoAutorizado' }
  /webhook/prueba:
    post:
      tags: [Cuenta y llaves]
      summary: Mandar un aviso de prueba al webhook
      responses:
        '200': { description: Encolado }
        '409': { description: Primero registra la dirección del webhook. }
        '401': { $ref: '#/components/responses/NoAutorizado' }
  /llaves:
    get:
      tags: [Cuenta y llaves]
      summary: Listar las llaves de API
      description: Nunca devuelve la llave completa, solo su prefijo.
      responses:
        '200':
          description: Llaves
          content:
            application/json:
              schema:
                type: object
                properties:
                  llaves: { type: array, items: { type: object, properties: { id: { type: string }, nombre: { type: string }, prefijo: { type: string }, activo: { type: boolean }, last_used_at: { type: string, format: date-time, nullable: true }, created_at: { type: string, format: date-time } } } }
    post:
      tags: [Cuenta y llaves]
      summary: Crear una llave
      description: La llave completa se muestra **una sola vez**.
      requestBody:
        content: { application/json: { schema: { type: object, properties: { nombre: { type: string, maxLength: 60 } } } } }
      responses:
        '201':
          description: Llave creada
          content: { application/json: { schema: { type: object, properties: { api_key: { type: string }, prefijo: { type: string }, aviso: { type: string } } } } }
  /llaves/{id}:
    delete:
      tags: [Cuenta y llaves]
      summary: Desactivar una llave
      description: No se puede desactivar la única llave activa (409).
      parameters: [{ name: id, in: path, required: true, schema: { type: string } }]
      responses:
        '200': { description: Desactivada }
        '404': { $ref: '#/components/responses/NoEncontrado' }
        '409': { $ref: '#/components/responses/Conflicto' }
components:
  securitySchemes:
    llaveEmpresa:
      type: http
      scheme: bearer
      description: La llave de tu empresa, que empieza con `ecf_`. Úsala solo desde tu servidor.
  parameters:
    Id:
      name: id
      in: path
      required: true
      description: Id del comprobante o su e-NCF.
      schema: { type: string }
  responses:
    NoAutorizado: { description: 'Falta la llave, es inválida o está desactivada (o la empresa está desactivada).', content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } } }
    NoEncontrado: { description: No existe (o es de otra empresa)., content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } } }
    Conflicto: { description: 'Sin certificado, sin secuencia disponible para el tipo, rango solapado o conflicto de llaves.', content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } } }
    Invalido:
      description: Los datos no cumplen el esquema de la DGII. No se consumió ningún e-NCF.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - type: object
                properties:
                  detalle: { type: object, properties: { problemas: { type: array, items: { type: object, properties: { path: { type: string }, code: { type: string }, message: { type: string } } } } } }
  schemas:
    Error:
      type: object
      properties:
        error: { type: string }
    Estado:
      type: string
      enum: [pendiente, enviando, enviado, aceptado, aceptado_condicional, rechazado, error]
      description: |
        pendiente: esperando su envío · enviado: la DGII lo recibió y lo valida · aceptado y aceptado_condicional: válidos · rechazado: anulado por la DGII · error: no se pudo completar tras varios reintentos.
    Persona:
      type: object
      properties:
        rnc: { type: string, description: RNC (9 dígitos) o cédula (11). }
        razonSocial: { type: string, maxLength: 150 }
        correo: { type: string }
        direccion: { type: string }
        contacto: { type: string }
    Item:
      type: object
      required: [nombre, tipo, cantidad, precio, itbis]
      properties:
        nombre: { type: string }
        descripcion: { type: string }
        tipo: { type: integer, enum: [1, 2], description: '1 bien, 2 servicio.' }
        cantidad: { type: number, exclusiveMinimum: true, minimum: 0, description: Hasta 2 decimales. }
        unidadMedida: { type: string }
        precio: { type: number, description: 'Precio unitario sin ITBIS, hasta 4 decimales.' }
        descuento: { type: number, description: Monto total del descuento de la línea. }
        itbis: { description: 'Tasa de ITBIS: 18, 16, 0 o "exento".', oneOf: [{ type: integer, enum: [18, 16, 0] }, { type: string, enum: [exento] }] }
        retencion:
          type: object
          description: Tipos 41 y 47. agente 1 = retención, 2 = percepción.
          required: [agente]
          properties: { agente: { type: integer, enum: [1, 2] }, itbisRetenido: { type: number }, isrRetenido: { type: number } }
        impuestosAdicionales:
          type: array
          maxItems: 2
          description: 'Otros impuestos adicionales de la línea (máximo 2 contando la propina legal). Con tasa fija (002, 003, 004) el monto se calcula solo; para 005 y los ISC (006 a 039) manda monto y tasa.'
          items: { type: object, required: [codigo], properties: { codigo: { type: string, example: '004' }, monto: { type: number }, tasa: { type: number } } }
        propinaLegal: { type: boolean, description: Aplica la propina legal del 10 % a esta línea. }
    ComprobanteEntrada:
      type: object
      required: [tipo, tipoPago, emisor, items]
      properties:
        idempotency_key: { type: string, maxLength: 120 }
        tipo: { type: integer, enum: [31, 32, 33, 34, 41, 43, 44, 45, 46, 47], description: '31 crédito fiscal, 32 consumo, 33 nota de débito, 34 nota de crédito, 41 compras, 43 gastos menores, 44 regímenes especiales, 45 gubernamental, 46 exportaciones, 47 pagos al exterior.' }
        tipoPago: { type: integer, enum: [1, 2], description: '1 contado, 2 crédito.' }
        fechaEmision: { type: string, example: 02-10-2026, description: 'DD-MM-AAAA. Por defecto, hoy en hora de República Dominicana.' }
        emisor:
          type: object
          required: [razonSocial, direccion]
          description: El RNC es el de tu empresa; no se toma de la petición.
          properties:
            razonSocial: { type: string }
            direccion: { type: string }
            nombreComercial: { type: string }
            sucursal: { type: string }
            correo: { type: string }
            telefonos: { type: array, items: { type: string }, maxItems: 3 }
            actividadEconomica: { type: string }
            numeroFacturaInterna: { type: string }
        comprador: { $ref: '#/components/schemas/Persona' }
        tipoIngresos: { type: string, default: '01' }
        fechaLimitePago: { type: string, example: 31-10-2026 }
        formasPago:
          type: array
          maxItems: 7
          items:
            type: object
            required: [forma, monto]
            properties:
              forma: { type: integer, minimum: 1, maximum: 8, description: '1 efectivo, 2 cheque/transferencia/depósito, 3 tarjeta, 4 venta a crédito, 5 bonos o certificados de regalo, 6 permuta, 7 nota de crédito, 8 otras.' }
              monto: { type: number }
        items: { type: array, minItems: 1, maxItems: 1000, items: { $ref: '#/components/schemas/Item' } }
        referencia:
          type: object
          description: Obligatoria en los tipos 33 y 34.
          required: [ncfModificado, fecha, codigoModificacion]
          properties:
            ncfModificado: { type: string, example: E310000000001 }
            fecha: { type: string, example: 02-10-2026 }
            codigoModificacion: { type: integer, minimum: 1, maximum: 5 }
            razon: { type: string }
            rncOtroContribuyente: { type: string }
        indicadorNotaCredito: { type: integer, enum: [0, 1], description: 'Solo tipo 34: 0 dentro de 30 días, 1 pasados 30 días.' }
        otraMoneda:
          type: object
          description: Cobro en otra moneda. Los montos principales siguen en pesos; este bloque informa la moneda, la tasa de cambio y los montos en esa moneda.
          required: [tipoMoneda, tipoCambio, montoTotal]
          properties:
            tipoMoneda: { type: string, example: USD, description: 'Código de moneda de la DGII (no DOP).' }
            tipoCambio: { type: number, example: 60.4545 }
            montoGravado: { type: number }
            montoExento: { type: number }
            totalItbis: { type: number }
            montoTotal: { type: number }
        informacionesAdicionales: { type: object, additionalProperties: true, description: 'Tipo 46 y otros: etiquetas del bloque InformacionesAdicionales de la DGII (FechaEmbarque, NumeroEmbarque, TotalFob, …).' }
        transporte: { type: object, additionalProperties: true, description: 'Etiquetas del bloque Transporte de la DGII (ViaTransporte, PaisDestino, …).' }
    Totales:
      type: object
      description: Todos los montos como texto con dos decimales.
      properties:
        montoGravadoTotal: { type: string }
        montoExento: { type: string }
        totalItbis: { type: string }
        montoImpuestoAdicional: { type: string }
        propinaLegal: { type: string }
        montoTotal: { type: string }
    ComprobanteCreado:
      type: object
      properties:
        id: { type: string }
        encf: { type: string, example: E310000000001 }
        estado: { $ref: '#/components/schemas/Estado' }
        monto_total: { type: number }
        codigo_seguridad: { type: string, description: Primeros 6 caracteres de la firma; va en la representación impresa. }
        via_resumen: { type: boolean, description: true si se enviará a la DGII como resumen (RFCE). }
        totales: { $ref: '#/components/schemas/Totales' }
        repetido: { type: boolean, description: true si la idempotency_key ya existía. }
    ComprobanteResumen:
      type: object
      properties:
        id: { type: string }
        tipo: { type: integer }
        encf: { type: string }
        estado: { $ref: '#/components/schemas/Estado' }
        monto_total: { type: number }
        codigo_seguridad: { type: string }
        track_id: { type: string, nullable: true }
        dgii_estado: { type: string, nullable: true }
        ultimo_error: { type: string, nullable: true }
        requiere_resumen: { type: boolean }
        created_at: { type: string, format: date-time }
    ComprobanteDetalle:
      allOf:
        - $ref: '#/components/schemas/ComprobanteResumen'
        - type: object
          properties:
            dgii_codigo: { type: integer, nullable: true }
            dgii_mensajes: { nullable: true, description: Mensajes de la DGII sobre la validación. }
            secuencia_reutilizable: { type: boolean, nullable: true, description: 'Si el comprobante fue rechazado, indica si ese e-NCF puede volver a usarse.' }
            intentos: { type: integer }
            updated_at: { type: string, format: date-time }
