Método REST API Emisión

Los datos de acceso son:
URL: [https://demoemisionv2.thefactoryhka.com.ve/api/Emision|https://demoemisionv2.thefactoryhka.com.ve/api/Emision]]
Method: POST

Cuando su sistema vaya a consumir el servicio para generar una factura o nota, debe primero haber consumido el metodo autenticacion para recibir un token de autenticacion, que va a incluir en la cabecera del request (petición), como “bearer token”

A continuación un ejemplo de los campos que pueden enviar en la petición:

Request:

Request.json

{
  "documentoElectronico": {
    "encabezado": {
      "identificacionDocumento": {
        "tipoDocumento": "string",
        "numeroDocumento": "string",
        "tipoProveedor": "string",
        "tipoTransaccion": "string",
        "numeroPlanillaImportacion": "string",
        "numeroExpedienteImportacion": "string",
        "serieFacturaAfectada": "string",
        "numeroFacturaAfectada": "string",
        "fechaFacturaAfectada": "string",
        "montoFacturaAfectada": "string",
        "comentarioFacturaAfectada": "string",
        "regimenEspTributacion": "string",
        "fechaEmision": "string",
        "fechaVencimiento": "string",
        "horaEmision": "string",
        "anulado": true,
        "tipoDePago": "string",
        "serie": "string",
        "sucursal": "string",
        "tipoDeVenta": "string",
        "moneda": "str",
        "transaccionId": "string"
      },
      "vendedor": {
        "codigo": "string",
        "nombre": "string",
        "numCajero": "string"
      },
      "comprador": {
        "tipoIdentificacion": "string",
        "numeroIdentificacion": "string",
        "razonSocial": "string",
        "direccion": "string",
        "ubigeo": "string",
        "pais": "st",
        "notificar": "string",
        "telefono": [
          "string"
        ],
        "correo": [
          "string"
        ],
        "otrosEnvios": [
          {
            "tipo": "string",
            "destino": "string"
          }
        ]
      },
      "sujetoRetenido": {
        "tipoIdentificacion": "string",
        "numeroIdentificacion": "string",
        "razonSocial": "string",
        "direccion": "string",
        "ubigeo": "string",
        "pais": "st",
        "notificar": "string",
        "telefono": [
          "string"
        ],
        "correo": [
          "string"
        ],
        "otrosEnvios": [
          {
            "tipo": "string",
            "destino": "string"
          }
        ]
      },
      "tercero": {
        "tipoIdentificacion": "string",
        "numeroIdentificacion": "string",
        "razonSocial": "string",
        "direccion": "string",
        "tipo": "string",
        "correo": [
          "string"
        ]
      },
      "totales": {
        "nroItems": "stri",
        "montoGravadoTotal": "string",
        "montoExentoTotal": "string",
        "subtotal": "string",
        "totalAPagar": "string",
        "totalIVA": "string",
        "montoTotalConIVA": "string",
        "montoEnLetras": "string",
        "totalDescuento": "string",
        "listaDescBonificacion": [
          {
            "descDescuento": "string",
            "montoDescuento": "string"
          }
        ],
        "impuestosSubtotal": [
          {
            "codigoTotalImp": "string",
            "alicuotaImp": "string",
            "baseImponibleImp": "string",
            "valorTotalImp": "string"
          }
        ],
        "formasPago": [
          {
            "descripcion": "string",
            "fecha": "string",
            "forma": "string",
            "monto": "string",
            "moneda": "str",
            "tipoCambio": "string"
          }
        ]
      },
      "totalesRetencion": {
        "totalBaseImponible": "string",
        "numeroCompRetencion": "string",
        "fechaEmisionCR": "string",
        "totalIVA": "string",
        "totalRetenido": "string",
        "totalISRL": "string",
        "totalIGTF": "string"
      },
      "totalesOtraMoneda": {
        "moneda": "string",
        "tipoCambio": "string",
        "montoGravadoTotal": "string",
        "montoExentoTotal": "string",
        "subtotal": "string",
        "totalAPagar": "string",
        "totalIVA": "string",
        "montoTotalConIVA": "string",
        "montoEnLetras": "string",
        "totalDescuento": "string",
        "listaDescBonificacion": [
          {
            "descDescuento": "string",
            "montoDescuento": "string"
          }
        ],
        "impuestosSubtotal": [
          {
            "codigoTotalImp": "string",
            "alicuotaImp": "string",
            "baseImponibleImp": "string",
            "valorTotalImp": "string"
          }
        ]
      },
      "orden": {
        "numero": "string",
        "correo": [
          "string"
        ]
      }
    },
    "detallesItems": [
      {
        "numeroLinea": "stri",
        "codigoCIIU": "string",
        "codigoPLU": "string",
        "indicadorBienoServicio": "string",
        "descripcion": "string",
        "cantidad": "string",
        "unidadMedida": "str",
        "precioUnitario": "string",
        "precioUnitarioDescuento": "string",
        "montoBonificacion": "string",
        "descripcionBonificacion": "string",
        "descuentoMonto": "string",
        "precioItem": "string",
        "codigoImpuesto": "string",
        "tasaIVA": "string",
        "valorIVA": "string",
        "valorTotalItem": "string",
        "infoAdicionalItem": [
          {
            "campo": "string",
            "valor": "string"
          }
        ],
        "listaItemOTI": [
          {
            "tasaOTI": "string",
            "codigoOTI": "stri",
            "valorOTI": "string"
          }
        ]
      }
    ],
    "detallesRetencion": [
      {
        "numeroLinea": "stri",
        "fechaDocumento": "string",
        "serieDocumento": "string",
        "tipoDocumento": "string",
        "numeroDocumento": "string",
        "numeroControl": "string",
        "tipoTransaccion": "string",
        "montoTotal": "string",
        "montoExento": "string",
        "baseImponible": "string",
        "porcentajeIVA": "string",
        "montoIVA": "string",
        "retenidoIVA": "string",
        "percibido": "string",
        "moneda": "str",
        "infoAdicionalItem": [
          {
            "campo": "string",
            "valor": "string"
          }
        ]
      }
    ],
    "viajes": {
      "nombreApellidoPasajero": "string",
      "tipoIdentificacion": "s",
      "numeroIdentificacion": "string",
      "domicilioFiscalPasajero": "string",
      "numeroTelePasajero": "string",
      "razonSocialServTransporte": "string",
      "numeroBoleto": "string",
      "fechaSalida": "string",
      "horaSalida": "string",
      "fechaLlegada": "string",
      "horaLlegada": "string",
      "unidadVolumen": "str",
      "nombrePuertoEmbarque": "string",
      "condicionesEntrega": "string",
      "puntoSalida": "string",
      "puntoDestino": "string"
    },
    "infoAdicional": [
      {
        "campo": "string",
        "valor": "string"
      }
    ],
    "guiaDespacho": {
      "esGuiaDespacho": "string",
      "motivoTraslado": "string",
      "descripcionServicio": "string",
      "tipoProducto": "string",
      "origenProducto": "string",
      "pesoOVolumenTotal": "string",
      "destinoProducto": "string",
      "conductor": {
        "nombreCompleto": "string",
        "tipoIdentificacion": "string",
        "numeroIdentificacion": "string",
        "tipoLicencia": "string",
        "infoContacto": "string"
      },
      "vehiculo": {
        "tipoVehiculo": "string",
        "numeroTransporte": "string",
        "numeroPlaca": "string"
      },
      "transportista": {
        "razonSocial": "string",
        "numeroIdentificacion": "string",
        "domicilioFiscal": "string"
      }
    },
    "transporte": {
      "tipo": "string",
      "descripcion": "string",
      "codigo": "string",
      "origen": "string",
      "destino": "string",
      "fechaEntrada": "string",
      "fechaSalida": "string",
      "lugarEntrega": "string",
      "lugarRecepcion": "string",
      "placa": "string"
    },
    "esLote": true,
    "esMinimo": true
  }
}

El servicio, al consignar la información, le responderá de la siguiente manera
Response:

Response.json

{
    "resultado": {
        "imprentaDigital": "THE FACTORY HKA VENEZUELA, C.A.",
        "autorizado": "Imprenta Digital Autorizada mediante Providencia SENIAT/INTI/XXXXXXX de fecha 09/09/2022",
        "serie": "",
        "tipoDocumento": "01",
        "numeroDocumento": "51359",
        "numeroControl": "00-00001325",
        "fechaAsignacion": "22/06/2023",
        "horaAsignacion": "10:30:38 AM",
        "fechaAsignacionNumeroControl": "06/05/2024",
        "horaAsignacionNumeroControl": "02:21:25 PM",
        "rangoAsignado": "Nros. de Control desde el 00-00000001 hasta 00-00050000"
    },
    "codigo": "200",
    "mensaje": "Documento procesado correctamente"
}

Códigos de respuesta del API

Conoce cómo manejar los diferentes tipos de errores que pueden ocurrir en las solicitudes a nuestros endpoints