Operaciones
Autorización de comprobantes
Autoriza cualquier tipo de comprobante electrónico existente.
Autorizar comprobante
Autoriza cualquier tipo de comprobante electrónico existente.
El ID del documento id-doc es el ID que obtienes después de crear un documento.
Operación
POST /edocs/<id-doc>/issue
Requerimiento de ejemplo
curl -v https://invoice.taxo.ws/edocs/<id-doc>/issue \
-H "Content-Type: application/json" \
-H "X-Key: <clave-del-api>" \
-H "X-Password: <clave-certificado-firma>"
import requests
cabeceras = {
'x-key': '<clave-del-api>',
'x-password': '<clave-certificado-firma>',
'content-type': 'application/json'}
respuesta = requests.get(
'https://invoice.taxo.ws/edocs/<id-factura>/issue',
headers = cabeceras)
using RestSharp;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace TaxoClient {
class InvoicingServiceClient {
static void Main(string[] args) {
var client = new RestClient("https://invoice.taxo.ws/edocs/");
var idDocumento = "<id-doc>/issue";
var request = new RestRequest("edocs/" + idDocumento, Method.GET);
request.AddHeader("X-Key", "<clave-del-api>");
request.AddHeader("X-Password", "<clave-certificado-firma>");
request.AddHeader("Content-Type", "application/json");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
}
}
}
Requerimiento
Reemplaza en la ruta <id-doc> por el ID de la factura que necesitas consultar.
Respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
| emisor | objeto tipo emisor | Información completa del emisor. |
| estado | string | Estado de autorización del comprobante. Posibles valores: AUTORIZADO, NO AUTORIZADO, ENVIADO, DEVUELTO, RECIBIDO, ERROR |
| numero | string | Número completo del documento. Ejm: 001-002-592738007 |
| url_formato_impresion | url | Esta URL te permite acceder de manera directa al formato de impresión (RIDE) del comprobante |
| url_documento_electronico | url | Esta URL te permite acceder de manera directa al documento electrónico (XML) |
| tipo | string | Código que representa el tipo de documento. Revisa aquí el código que corresponde a cada tipo de documento |
| id | string | El id del documento consultado |
| ambiente | integer | Pruebas: 1.Producción 2. |
| receptor | objeto tipo receptor | Informaci'on del receptor del documento. |
| clave_acceso | string | Clave de acceso del documento. |
| autorizacion | Objeto de tipo autorización SRI |
Respuesta de ejemplo
Respuesta
{
"emisor": {
"provincia": 10,
"email": "[email protected]",
"categoria": "Software",
"ruc": "0992712554001",
"obligado_contabilidad": true,
"contribuyente_especial": "",
"subcategoria": "Sorftware como Servicio",
"nombre_comercial": "Taxo",
"pais": 1,
"market_id": null,
"razon_social": "XYZ Corporación S.A.",
"direccion": "Av. Primera 234 y calle 5ta",
"ciudad": "Guayaquil",
"exportador": false,
"telefono": "099999999",
"tipoentidad": "Sociedad Anónima"
},
"estado": "RECIBIDO",
"numero": "001-002-000000001",
"url_formato_impresion": "https://invoice.taxo.ws/ver/67aa7c650g395cgb16e18df3d8ff18fc/pdf",
"url_documento_electronico": "https://invoice.taxo.ws/ver/67aa7c650g395cgb16e18df3d8ff18fc/xml",
"tipo": "01",
"id": "67aa7c650g395cgb16e18df3d8ff18fc",
"ambiente": "1",
"receptor": {
"identificacion": "0987654321001",
"telefono": "",
"email": "[email protected]",
"tipo_identificacion": "04",
"direccion": "Av. Primera 234 y calle 5ta"
},
"clave_acceso": "0803202101099271255400110010020000000011994720519",
"autorizacion": {
"mensajes": []
}
}
Consulta de autorización
Consulta la información de autorización de cualquier tipo de comprobante electrónico.
El ID del documento id-doc es el ID que obtienes después de emitir un documento.
Operación
GET /edocs/<id-doc>
Requerimiento
Reemplaza en la ruta <id-doc> por el ID de la factura que necesitas consultar.
Requerimiento de ejemplo
curl -v https://invoice.taxo.ws/edocs/<id-doc> \
-H "Accept: application/json" \
-H "X-Key: <clave-del-api>"
import requests
cabeceras = {'x-key': '<clave-del-api>'}
respuesta = requests.get(
'https://invoice.taxo.ws/edocs/<id-factura>',
headers = cabeceras)
using RestSharp;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace TaxoClient {
class InvoicingServiceClient {
static void Main(string[] args) {
var client = new RestClient("https://invoice.taxo.ws/");
var idDocumento = "<id-doc>";
var request = new RestRequest("edocs/" + idDocumento, Method.GET);
request.AddHeader("X-Key", "<clave-del-api>");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
}
}
}
Respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | string | El id del documento consultado |
| tipo | string | Código que representa el tipo de documento. Revisa aquí el código que corresponde a cada tipo de documento |
| estado | string | Estado de autorización del comprobante. Posibles valores: AUTORIZADO, NO AUTORIZADO, ENVIADO, DEVUELTO, RECIBIDO, ERROR |
| clave_acceso | string | Clave de acceso del documento. |
| url_formato_impresion | url | Esta URL te permite acceder de manera directa al formato de impresión (RIDE) del comprobante |
| url_documento_electronico | url | Esta URL te permite acceder de manera directa al documento electrónico (XML) |
| autorizacion | Objeto de tipo autorización SRI |
Respuesta de ejemplo
Respuesta
{
"url_documento_electronico": "https://invoice.taxo.ws/ver/be69b7bc64b643718a643caa9a8c3569/xml",
"autorizacion": {
"fecha": "2020-01-23T15:41:51Z",
"estado": "AUTORIZADO",
"mensajes": [],
"numero": "2301202035679285132400120010020000287082794874518"
},
"tipo": "01",
"url_formato_impresion": "https://invoice.taxo.ws/ver/be69b7bc64b643718a643caa9a8c3569/pdf",
"clave_acceso": "2301202035679285132400120010020000287082794874518",
"estado": "AUTORIZADO",
"id": "be69b7bc64b643718a643caa9a8c3569",
"ambiente": "2"
}