API FE 4.4

Emisión de documentos elecrónicos
Ejemplos de cómo emitir un documento electrónico:
Factura electrónicaNota de créditoNota de débitoTiquete electrónico

Factura electrónica
Endpoint POST /api/2.0/documentos-electronicos/emision/factura 

 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/factura' \

--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",

 "codigo_actividad_receptor": "851207", 

 "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,

 "tipo_cedula": "01",

 "cedula": "701750946",

 "nombre": "Prueba",

 "correo": "prueba@prueba.com",

 "telefono": "88888888",

 "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"

 }

 }

 }

 ]

}' 

 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.

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.