Skip to main content

Tiquete electrónico

Endpoint
POST /api/2.0/documentos-electronicos/emision/tiquete

Crea una nueva factura con la disposición 4.4 de Hacienda. Los siguientes datos son mínimos para la emisión de este documento.

curl --location 'https://app.facturadorvirtual.com/api/2.0/documentos-electronicos/emision/tiquete' \
--header 'api-token: iuJPbVCYQY3AmWuVHMflT9ZySlwzxb9ehviLbHNsz6yQnBm4' \
--header 'access-token: IDq4ME4ZUO9YmQ0fOc43AFp7mMO6talIuIALFaUUcs2H2pwLpYN2' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "orden": "1",
    "sucursal": "004",
    "punto": "00001",
    "actividad": "014002", 
    "medio_pago": {
        "01": { 
            "codigo": "01",
            "total": 130
        },
        "02": { 
            "codigo": "02",
            "total": 400
        },
        "06": { 
            "codigo": "06",
            "total": 600
        }
    },
    "condicion_venta": "01",
    "moneda": "CRC",
    "tipo_cambio": 1,
    "comentarios": "Factura de prueba por medio del API",
    "lineas": [
        {
            "codigo": "00001",
            "codigoCabys": "0196109000000",
            "descripcion": "Entrada a CRFW22",
            "cantidad": "1",
            "unidad": "Unid",
            "descuento": 0,
            "naturalezaDescuento": "",
            "precioUnitario": 1000,
            "impuestos": {
                "01": {
                    "tarifa": "08"
                }
            }
        }
    ]
}'

Receptor

Para incluir los datos del receptor, debe proporcionar los siguientes campos:

"codigo_actividad_receptor": "851207",
"tipo_cedula": "01",
"cedula": "701750946",
"nombre": "Prueba",
"correo": "prueba@prueba.com",
"telefono": "88888888",

Respuesta

Devuelve una respuesta en json con la confirmación satisfactoria o insatisfactoria de la emisión. A continuación se muestra una respuesta satisfactoria:

{
  "codigo": 200,
  "contenidoXml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iV…", 
  "contenidoXmlFirmado": "Nfdsfffadeec2lvbj0iMS4wIiBlbmNvZGluZz0iV…", 
  "documento": { 
    "clave": "50622032000070175094601000001010000000006118491223", 
    "recepcion": "recibido", 
    "comprobacion": "por_comprobar"
  }, 
  "errores": []
}

Caso contrario, muestra una respuesta insatisfactoria:

{
  "codigo": 500, 
  "contenidoXml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iV…", 
  "contenidoXmlFirmado": null, 
  "documento": { 
    "clave": "50622032000070175094601000001010000000006118491223", 
    "recepcion": "por_enviar",
    "comprobacion": "por_comprobar"
  }, 
  "errores": [ 
    { 
      "tipo": "error", 
      "mensaje": "No se ha podido enviar el documento a Hacienda porque su servicio de recepción presenta inconsistencias. El sistema intentará automáticamente en unos minutos"
    } ]
}

El valor de contenidoXml y contenidoXmlFirmado está codificado en base64. Ambos valores representan el contenido XML antes y después de ser firmado.

Comprobación

El documento se comprueba automáticamente, generalmente toda uno a dos minutos.