Emitir comprobante

Comprobantes - Emision

Emision, anulacion y cobro de comprobantes.

Descripcion

Valida permiso EMITIR_CFE y limite de politica cfe.maximo_por_mes. Genera XML desde el payload CFE, firma y registra CFE emitido. Si hay idComprobanteGuardado, elimina el cabezal previo (salvo Orden de Venta) y vuelve a registrar. Registra lineas, referencias, pie y comisiones segun tipo. Si hay idCaja, puede vincular caja. Devuelve datos del CFE (serie/numero/CAE/QR/XML).

Endpoint

Metodo: POST
Path: /api/v1/comprobante/emitir

Headers

Authorization: Bearer
Content-Type: application/json

Guías prácticas

Para ejemplos completos de cómo usar este endpoint, consulta las siguientes guías:

Request

curl -X POST '$BASE/api/v1/comprobante/emitir'

{
  "idEmpresa": 123,
  "codComercio": "001",
  "codTerminal": "T1",
  "adenda": "Texto libre",
  "uuid": "uuid-opcional",
  "destinatariosPdf": "correo1@dominio.com,correo2@dominio.com",
  "origen": "Api|Web|...",
  "esAppMovil": 0,
  "idComprobanteGuardado": 0,
  "idVendedor": 0,
  "idCaja": 0,
  "cfe": {
    "idDoc": {
      "tipoCfe": 111,
      "serie": "A",
      "numero": 1,
      "fechaEmision": "YYYY-MM-DD",
      "periodoDesde": "YYYY-MM-DD",
      "periodoHasta": "YYYY-MM-DD",
      "montoBruto": 0,
      "formaPago": 1,
      "fechaVencimiento": "YYYY-MM-DD",
      "fechaValor": "YYYY-MM-DD",
      "clausulaVenta": "...",
      "modalidadVenta": "...",
      "viaTransporte": "...",
      "tipoTraslado": "...",
      "indicadorPagoTerceros": "...",
      "indicadorCobranzaPropia": 0,
      "numeroInterno": "...",
      "informacionAdicional": "...",
      "secretoProfesional": "...",
      "indicadorCompraMEReventa": "...",
      "indicadorPropiedadMercaderiaTransportada": "...",
      "codPaisProp": "...",
      "tipoDocumentoProp": "...",
      "docProp": "...",
      "razonSocialProp": "..."
    },
    "emisor": {
      "ruc": "...",
      "razonSocial": "...",
      "nombreComercial": "...",
      "giro": "...",
      "telefono": "...",
      "segundoTelefono": "...",
      "email": "...",
      "sucursal": "...",
      "codigoDgiSucursal": "...",
      "domicilioFiscal": "...",
      "ciudad": "...",
      "departamento": "...",
      "informacionAdicional": "..."
    },
    "receptor": {
      "tipoDocumento": "...",
      "codigoPais": "...",
      "documento": "...",
      "documentoExt": "...",
      "razonSocial": "...",
      "direccion": "...",
      "ciudad": "...",
      "departamento": "...",
      "pais": "...",
      "codigoPostal": "...",
      "informacionAdicional": "...",
      "lugarEntrega": "...",
      "idCompraCliente": "...",
      "idCliente": "...",
      "idProveedor": "..."
    },
    "totales": {
      "tipoMoneda": "UYU",
      "tipoCambio": 1,
      "montoNoGravado": 0,
      "montoExportacionYAsim": 0,
      "montoImpuestoPercibido": 0,
      "montoIvaSuspenso": 0,
      "montoNetoIvaTasaMinima": 0,
      "montoNetoIvaTasaBasica": 0,
      "montoNetoIvaOtraTasa": 0,
      "tasaIvaTasaMinima": 0,
      "tasaIvaTasaBasica": 0,
      "montoIvaTasaMinima": 0,
      "montoIvaTasaBasica": 0,
      "montoIvaOtraTasa": 0,
      "montoTotal": 0,
      "montoTotalRetenido": 0,
      "cantidadLineasDetalle": 1,
      "montoNoFacturable": 0,
      "montoPagar": 0,
      "retencionesPercepciones": [],
      "montoCreditoFiscal": 0
    },
    "detalles": [
      {
        "numeroLineaDetalle": 1,
        "indicadorFacturacion": 1,
        "nombreItem": "...",
        "NCM": "...",
        "descripcionItem": "...",
        "cantidad": 1,
        "unidadMedida": "...",
        "precioUnitario": "0.00",
        "descuentoPct": 0,
        "descuentoMonto": 0,
        "recargoPct": 0,
        "recargoMonto": 0,
        "montoItem": 0,
        "indicadorAgenteResponsable": "...",
        "codigos": [],
        "retencionesPercepciones": [],
        "subDescuentos": [],
        "idVariante": "...",
        "idListaPrecio": "..."
      }
    ],
    "referencias": [
      {
        "numeroLineaReferencia": 1,
        "indicadorGlobal": "...",
        "tipoDocumentoReferencia": "...",
        "serieFacturaReferencia": "...",
        "numeroFacturaReferencia": "...",
        "razonReferencia": "...",
        "fechaFacturaReferencia": "YYYY-MM-DD",
        "tipoMonedaCfeReferencia": "...",
        "tipoCambioCfeReferencia": "...",
        "montoCfeReferencia": "..."
      }
    ],
    "descuentosRecargosGlobales": [
      {
        "numeroLinea": 1,
        "tipoMovimiento": "...",
        "tipoDescuento": "...",
        "codigoDescuento": "...",
        "glosa": "...",
        "valorDescuento": "...",
        "indicadorFacturacion": "..."
      }
    ],
    "mediosPago": [
      {
        "numeroLineaMedioPago": 1,
        "codigoMedioPago": "...",
        "glosaMedioPago": "...",
        "ordenMedioPago": "...",
        "valorPago": "..."
      }
    ],
    "subTotalesInfo": [
      {
        "numeroLineaSubtotal": 1,
        "glosaSubtotal": "...",
        "ordenSubtotal": "...",
        "valorSubtotal": "..."
      }
    ],
    "complementoFiscal": {
      "tipoDocumento": "...",
      "codPais": "...",
      "nroDocumento": "...",
      "nombreMandante": "..."
    }
  }
}

Response

{
  "_Id": 999,
  "CodRespuesta": "00",
  "MensajeRespuesta": "OK",
  "IdComprobante": 123,
  "TipoCfe": 111,
  "Serie": "A",
  "Nro": 1,
  "IdCAE": "...",
  "NroInicalCAE": "...",
  "NroFinalCAE": "...",
  "DatosQR": "...",
  "CodSeguridad": "...",
  "XmlFirmado": "<xml>..."
}

Errores

Empresa deshabilitada
La fecha de emision no puede ser anterior a la fecha de inicio de actividad de la empresa (YYYY-MM-DD).
Politica cfe.maximo_por_mes: PoliticaServicio::mensajeUso(...)
El XML no es un CFE valido