Comprobantes

Guías de remisión

POST /waybills/issue

Emisión de una guía de remisión

Operación

POST /waybills/issue

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/waybills/issue \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '{
  "ambiente":1,
  "tipo_emision":1,
  "secuencial":50,
  "fecha_inicio_transporte":"2015-02-28T11:28:56.782Z",
  "fecha_fin_transporte":"2015-02-28T11:28:56.782Z",
  "direccion_partida": "Victor Emilio Estrada",
  "emisor":{
    "ruc":"0910000000001",
    "obligado_contabilidad":true,
    "contribuyente_especial":"12345",
    "nombre_comercial":"XYZ Corp",
    "razon_social":"XYZ Corporación S.A.",
    "direccion":"Av. Primera 234 y calle 5ta",
    "establecimiento":{
      "punto_emision":"002",
      "codigo":"001",
      "direccion":"Av. Primera 234 y calle 5ta"
    }
  },
  "informacion_adicional":{
    "Tiempo de entrega":"5 días"
  },
  "transportista":{
    "email":"[email protected]",
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "telefono":"04 6029400",
    "placa":"GSM-0123"
  },
  "destinatarios": [{
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "email":"[email protected]",
    "telefono":"046029400",
    "fecha_emision_documento_sustento": "2015-02-27T11:28:56.782Z",
    "numero_documento_sustento": "001-001-000000008",
    "numero_autorizacion_documento_sustento": "0123456789",
    "motivo_traslado": "Venta",
    "tipo_documento_sustento": "01",
    "ruta": "GYE - UIO",
    "documento_aduanero_unico": "",
    "codigo_establecimiento_destino": "001",
    "items": [{
      "cantidad": 1.0,
      "codigo_principal": "SPS",
      "codigo_auxiliar": "001",
      "descripcion": "Playstation 4",
      "detalles_adicionales": {
        "numero": "DFGDG2342-2",
        "serie": "1-2014-2"
      }
    }]
  }]
}'

Para la emisión de una guía de remisión se debe enviar la información completa del comprobante en el cuerpo del requerimiento en formato JSON.

ParámetroTipoDescripción
secuencialstringNúmero de secuencia de la guía de remisión. Requerido
emisoremisorInformación completa del emisor. Requerido
fecha_inicio_transportestringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601. Requerido
fecha_fin_transportestringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601. Requerido
direccion_partidastringDirección de partida. Requerido
transportistaobjeto tipo transportistaInformación de la persona que transporta la carga. Requerido
ambienteintegerPruebas: 1.
Producción 2.
Requerido
tipo_emisionintegerEmisión normal: 1.
Emisión por indisponibilidad: 2
Requerido
destinatarioslistado de objetos tipo destinatarioDescripción de destinatarios y la mercadería transportada. Requerido
versionstringVersión del formato de comprobantes electrónicos de SRI. Si no se especifica, se utilizará la última revisión del formato implementada,
clave_accesostringLa clave de acceso representa un identificador único del comprobante. Si esta información no es provista, Taxo Facturación la generará.
¿Cómo generar la clave de acceso?
informacion_adicionalobjetoInformación adicional adjunta al comprobante en forma de diccionario. Ejemplo:
{"email": "[email protected]", "Carga asegurada por": "Securitas"} Obsoleto utiliza el parámetro info_adicional
info_adicionalListado de objetos de tipo información adicionalInformación adicional adjunta al comprobante en forma de diccionario. Ejemplo:
[{"nombre":"plan", "valor":"Inicial", "nombre":"vigencia", "valor":"1 mes"}]

Destinatario

ParámetroTipoDescripción
razon_socialstringRazón social del comprador. Máximo 300 caracteres. Requerido
identificacionstringDe 5 a 20 caracteres. Requerido
tipo_identificacionstringVer tabla de tipos de identificación Requerido
emailstringCorreo electrónico del destinatario.
telefonostringTeléfono.
direccionstringDirección. Requerido
rutastringRuta de transporte. Máximo 300 caracteres.
documento_aduanero_unicostringMáximo 20 caracteres.
fecha_emision_documento_sustentostringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601.
numero_documento_sustentostringNúmero completo del documento que detalla la mercadería a transportar. Normalmente facturas. Ejm: 001-002-010023098
codigo_establecimiento_destinostringNúmero establecimiento que recibe la entrega. Ejm: 002
tipo_documento_sustentostringVer códigos de tipos de documentos.
motivo_trasladostringMotivo del traslado. Ejm: Entrega de mercadería. Requerido
numero_autorizacion_documento_sustentostringAutorización del documento de sustento.
itemsarreglo de objetos tipo item destinatarioItems transportados. Requerido

Item destinatario

ParámetroTipoDescripción
descripcionstringDescripción del ítem. Requerido
codigo_principalstringCódigo alfanumérico de uso del comercio. Máximo 25 caracteres. Requerido
codigo_auxiliarstringCódigo alfanumérico de uso del comercio. Máximo 25 caracteres.
cantidadfloat (hasta 6 cifras decimales)Cantidad de items. Requerido
detalles_adicionalesobjectDiccionario de datos de carácter adicional. Ejemplo:
{"marca": "Ferrari", "chasis": "UANEI832-NAU101"}

Transportista

ParámetroTipoDescripción
razon_socialstringRazón social. Máximo 300 caracteres. Requerido
identificacionstringDe 5 a 20 caracteres. Requerido
tipo_identificacionstringVer tabla de tipos de identificación Requerido
emailstringCorreo electrónico. Máximo 300 caracteres.
telefonostringTeléfono.
direccionstringDirección
placastringPlaca del vehículo. Requerido

Respuesta

Respuesta de ejemplo

Respuesta
{
  "id": "abcfde09817263847cdaef8493018fef",
  "clave_acceso":"2802201501091000000000120010010000100451993736618",
  "ambiente":1,
  "tipo_emision":1,
  "secuencial":50,
  "fecha_inicio_transporte":"2015-02-28T11:28:56.782Z",
  "fecha_fin_transporte":"2015-02-28T11:28:56.782Z",
  "emisor":{
    "ruc":"0910000000001",
    "obligado_contabilidad":true,
    "contribuyente_especial":"12345",
    "nombre_comercial":"XYZ Corp",
    "razon_social":"XYZ Corporación S.A.",
    "direccion":"Av. Primera 234 y calle 5ta",
    "establecimiento":{
      "punto_emision":"002",
      "codigo":"001",
      "direccion":"Av. Primera 234 y calle 5ta"
    }
  },
  "informacion_adicional":{
    "Tiempo de entrega":"5 días"
  },
  "transportista":{
    "email":"[email protected]",
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "telefono":"04 6029400",
    "placa":"GSM-0123"
  },
  "destinatarios": [{
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "email":"[email protected]",
    "telefono":"046029400",
    "fecha_emision_documento_sustento": "2015-02-27T11:28:56.782Z",
    "numero_documento_sustento": "001-001-000000008",
    "numero_autorizacion_documento_sustento": "0123456789",
    "motivo_traslado": "Venta",
    "tipo_documento_sustento": "01",
    "ruta": "GYE - UIO",
    "documento_aduanero_unico": "",
    "codigo_establecimiento_destino": "001",
    "items": [{
      "cantidad": 1.0,
      "codigo_principal": "SPS",
      "codigo_auxiliar": "001",
      "descripcion": "Playstation 4",
      "detalles_adicionales": {
        "numero": "DFGDG2342-2",
        "serie": "1-2014-2"
      }
    }]
  }]
}

Retorna un objeto tipo guía de remisión que incluye un nuevo parámetro id, el cual identifica de manera única a la guía de remisión. El campo clave_acceso generado también se incluirá como parte de la respuesta.

Emisión de una guía de remisión a partir de XML

POST /waybills/issue/xml

Requerimiento a partir de XML

Para la emisión de una guia de remisión a partir de un XML se debe enviar contenido del archivo XML como parámetro en el cuerpo del requerimiento en formato JSON. Este XML debe cumplir con la especificación del SRI.

ParámetroTipoDescripción
xmlstringContenido del archivo xml. Requerido

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/waybills/issue/xml \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '{"xml": "<?xml version=\"1.1.0\" encoding=\"UTF-8\">
<guiaRemision id=\"comprobante\" version=\"1.1.0\">
  <infoTributaria>
    <ambiente>1</ambiente>
    <tipoEmision>1</tipoEmision>
    <razonSocial>TAXO S.A.</razonSocial>
    <nombreComercial>Taxo</nombreComercial>
    <ruc>1234567890001</ruc>
    <claveAcceso>0405202006123456789000110010010000000012235571913</claveAcceso>
    <codDoc>06</codDoc>
    <estab>001</estab>
    <ptoEmi>001</ptoEmi>
    <secuencial>000000001</secuencial>
    <dirMatriz>Innvernadero Coworking, Bálsamos 813 entre Guayacanes e Higueras</dirMatriz>
  </infoTributaria>
  <infoGuiaRemision>
    <dirEstablecimiento>Innvernadero Coworking, Bálsamos 813 entre Guayacanes e Higueras</dirEstablecimiento>
    <dirPartida>Calle única Numero 987</dirPartida>
    <razonSocialTransportista>Juan Perez</razonSocialTransportista>
    <tipoIdentificacionTransportista>05</tipoIdentificacionTransportista>
    <rucTransportista>0987654321</rucTransportista>
    <obligadoContabilidad>NO</obligadoContabilidad>
    <fechaIniTransporte>04/05/2020</fechaIniTransporte>
    <fechaFinTransporte>05/05/2020</fechaFinTransporte>
    <placa>GSM-0123</placa>
  </infoGuiaRemision>
  <destinatarios>
    <destinatario>
      <identificacionDestinatario>0953239092001</identificacionDestinatario>
      <razonSocialDestinatario>Santacruz Hernandez Anni Rosa</razonSocialDestinatario>
      <dirDestinatario>Solar 23</dirDestinatario>
      <motivoTraslado>Motivo del traslado</motivoTraslado>
      <codEstabDestino>001</codEstabDestino>
      <ruta>GYE - UIO</ruta>
      <codDocSustento>01</codDocSustento>
      <numDocSustento>001-001-000000001</numDocSustento>
      <fechaEmisionDocSustento>01/05/2020</fechaEmisionDocSustento>
      <detalles>
        <detalle>
          <codigoInterno>AGDAS-001</codigoInterno>
          <descripcion>Agua purificada</descripcion>
          <cantidad>1.000000</cantidad>
          <detallesAdicionales/>
        </detalle>
      </detalles>
    </destinatario>
  </destinatarios>
  <infoAdicional>
    <campoAdicional nombre=\"Campo Adicional\">Informacion Adicional</campoAdicional>
  </infoAdicional>
</guiaRemision>"}'

Respuesta de ejemplo

Respuesta
{
    "secuencial": "000000001",
    "emisor": {
        "ruc": "1234567890001",
        "razon_social": "TAXO S.A.",
        "nombre_comercial": "Taxo",
        "contribuyente_especial": "",
        "direccion": "Innvernadero Coworking, Bálsamos 813 entre Guayacanes e Higueras",
        "obligado_contabilidad": "NO",
        "establecimiento": {
            "punto_emision": "001",
            "codigo": "001",
            "direccion": "Innvernadero Coworking, Bálsamos 813 entre Guayacanes e Higueras"
        },
        "email": "[email protected]"
    },
    "direccion_partida": "Calle única Numero 987",
    "transportista": {
        "tipo_identificacion": "05",
        "razon_social": "Juan Perez",
        "direccion": "",
        "placa": "GSM-0123",
        "identificacion": "0987654321",
        "telefono": "",
        "email": ""
    },
    "fecha_fin_transporte": "2020-05-05T00:00:00-05:19",
    "destinatarios": [
        {
            "fecha_emision_documento_sustento": "2020-05-01T00:00:00-05:19",
            "email": "",
            "ruta": "GYE - UIO",
            "identificacion": "0953239092001",
            "motivo_traslado": "Motivo del traslado",
            "documento_aduanero_unico": "",
            "numero_documento_sustento": "001-001-000000001",
            "tipo_identificacion": "05",
            "codigo_establecimiento_destino": "001",
            "razon_social": "Santacruz Hernandez Anni Rosa",
            "numero_autorizacion_documento_sustento": "",
            "direccion": "Solar 23",
            "tipo_documento_sustento": "01",
            "items": [
                {
                    "codigo_auxiliar": "",
                    "descripcion": "Agua purificada",
                    "codigo_principal": "AGDAS-001",
                    "cantidad": 1.0,
                    "detalles_adicionales": {}
                }
            ],
            "telefono": ""
        }
    ],
    "id": "a8ea19c75f2546b883c4a00e9e68e1b9",
    "fecha_inicio_transporte": "2020-05-04T00:00:00-05:19",
    "informacion_adicional": {
        "Campo Adicional": "Informacion Adicional"
    },
    "ambiente": "1",
    "tipo_emision": 1,
    "clave_acceso": "0405202006123456789000110010010000000012235571913"
}

Consulta de una guía de remisión

Consulta una guía de remisión para obtener toda la información del comprobante, incluyendo el estado del mismo. El parámetro estado de la respuesta obtenida al invocar esta operación, indica el estado actual del comprobante.

Si es necesario conocer en detalle, en que estado del proceso de emisión, se debe examinar los parámetros envio_sri y autorizacion_sri de la respuesta.

Operación

GET /waybills/<receipt-id>

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/waybills/<id-guiaremision> \
-H "Content-Type: application/json" \
-H "X-Key: <clave-del-api>" \
-H "X-Password: <clave-certificado-firma>" \

Reemplaza en la ruta <receipt-id> por el id de la guía de remisión que necesitas consultar.

Respuesta

Respuesta de ejemplo

Respuesta
{
    "id": "abcf12343faad06785",
    "secuencial": "16",
    "fecha_emision": "2015-05-15",
    "version": "1.0.0",
    "clave_acceso": "1505201501099271255400110011000000000162092727615",
    "emisor": {
        "ruc": "0992712554001",
        "razon_social": "TAXO S.A.",
        "nombre_comercial": "Taxo",
        "direccion": null,
        "obligado_contabilidad": true,
        "contribuyente_especial": "",
        "establecimiento": {
            "codigo": "001",
            "direccion": "V.E. 112 Y CIRCUNVALACION NORTE",
            "punto_emision": "100"
        }
    },
    "estado": "AUTORIZADO",
    "correos_enviados": [
        {
            "fecha_envio": "2015-05-15T16:36:48.274604",
            "destinatarios": "[email protected]"
        }
    ],
    "guia_remision": "",
    "informacion_adicional": [],
    "ambiente": "1",
    "totales": {
        "total_sin_impuestos": "150.00",
        "descuento": "0.00",
        "propina": "0.00",
        "impuestos": [
            {
                "codigo": "2",
                "codigo_porcentaje": "2",
                "base_imponible": "150.00",
                "valor": "18.00"
            }
        ],
        "importe_total": "168.00"
    },
    "comprador": {
        "razon_social": "Carlos L. Plaza",
        "identificacion": "0900102222",
        "tipo_identificacion": 1,
        "email": "[email protected]",
        "direccion": "Calle Uno y Calle Dos",
        "telefono": "043334445"
    },
    "envio_sri": {
        "mensajes": [],
        "estado": "RECIBIDA",
        "fecha": ""
    },
    "tipo_emision": "1",
    "items": [
        {
            "detalles_adicionales": {
                "Estadía": "2 noches",
                "Habitación": "203"
            },
            "cantidad": "1.000000",
            "codigo_principal": "HAB",
            "codigo_auxiliar": "DOB",
            "descripcion": "Habitación doble",
            "precio_unitario": "150.000000",
            "descuento": "0.00",
            "precio_total_sin_impuestos": "",
            "impuestos": [
                {
                    "tarifa": "12.00",
                    "codigo": "2",
                    "codigo_porcentaje": "2",
                    "base_imponible": "150.00",
                    "valor": "18.00"
                }
            ]
        }
    ],
    "autorizacion": {
        "estado": "AUTORIZADO",
        "mensajes": [
            {
                "identificador": "60",
                "mensaje": "ESTE PROCESO FUE REALIZADO EN EL AMBIENTE DE PRUEBAS",
                "tipo": "INFORMATIVO",
                "informacion_adicional": ""
            }
        ],
        "numero": "1505201516323509927125540010266935227",
        "fecha": "2015-05-15T16:32:35.000380"
    }
}
ParámetroTipoDescripción
secuencialstringNúmero de secuencia de la guía de remisión. Requerido
emisoremisorInformación completa del emisor. Requerido
fecha_inicio_transportestringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601.
fecha_fin_transportestringFecha de emisión en formato AAAA-MM-DDHoraZonaHoraria, definido en el estándar ISO8601.
direccion_partidastringDirección de partida
transportistaobjeto tipo TransportistaInformación de la persona que transporta la carga
ambienteintegerPruebas: 1.
Producción 2.
Requerido
tipo_emisionintegerEmisión normal: 1.
Emisión por indisponibilidad: 2
Requerido
destinatarioslistado de objetos tipo destinatarioDescripción de destinatarios y la mercadería transportada. Requerido
versionstringVersión del formato de comprobantes electrónicos de SRI. Si no se especifica, se utilizará la última revisión del formato implementada,
clave_accesostringLa clave de acceso representa un identificador único del comprobante. Si esta información no es provista, Taxo Facturación la generará.
¿Cómo generar la clave de acceso?
envio_sriobjeto tipo envio sriInformación luego de enviar el comprobante.
autorizacionobjeto tipo autorizacion sriInformación de la autorización.org/html/rfc3339#section-5.6)
informacion_adicionalobjetoInformación adicional adjunta al comprobante en forma de diccionario. Ejemplo:
{"email": "[email protected]", "Carga asegurada por": "Securitas"}

Re-emisión de una guía de remisión

Operación

POST /waybills/:id/reissue

Requerimiento

Requerimiento de ejemplo

curl -v https://invoice.taxo.ws/waybills/<id-guiaremision>/reissue \
-H "Content-Type: application/json" \
-H "X-Key: <API-key>" \
-H "X-Password: <clave-certificado-firma>" \
-d '{
  "ambiente":1,
  "tipo_emision":1,
  "secuencial":50,
  "fecha_inicio_transporte":"2015-02-28T11:28:56.782Z",
  "fecha_fin_transporte":"2015-02-28T11:28:56.782Z",
  "direccion_partida": "Victor Emilio Estrada",
  "emisor":{
    "ruc":"0910000000001",
    "obligado_contabilidad":true,
    "contribuyente_especial":"12345",
    "nombre_comercial":"XYZ Corp",
    "razon_social":"XYZ Corporación S.A.",
    "direccion":"Av. Primera 234 y calle 5ta",
    "establecimiento":{
      "punto_emision":"002",
      "codigo":"001",
      "direccion":"Av. Primera 234 y calle 5ta"
    }
  },
  "informacion_adicional":{
    "Tiempo de entrega":"5 días"
  },
  "transportista":{
    "email":"[email protected]",
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "telefono":"04 6029400",
    "placa":"GSM-0123"
  },
  "destinatarios": [{
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "email":"[email protected]",
    "telefono":"046029400",
    "fecha_emision_documento_sustento": "2015-02-27T11:28:56.782Z",
    "numero_documento_sustento": "001-001-000000008",
    "numero_autorizacion_documento_sustento": "0123456789",
    "motivo_traslado": "Venta",
    "tipo_documento_sustento": "01",
    "ruta": "GYE - UIO",
    "documento_aduanero_unico": "",
    "codigo_establecimiento_destino": "001",
    "items": [{
      "cantidad": 1.0,
      "codigo_principal": "SPS",
      "codigo_auxiliar": "001",
      "descripcion": "Playstation 4",
      "detalles_adicionales": {
        "numero": "DFGDG2342-2",
        "serie": "1-2014-2"
      }
    }]
  }]
}'

Esta operación debe ser utilizada para corregir comprobantes NO AUTORIZADOS o DEVUELTOS por el Servicio de Rentas Internas.

En la URL de esta opción se debe incluir el id de la retención recibida al momento de emitirla.

El cuerpo del requerimiento es un objeto retención con los datos corregidos para que pueda ser procesado y autorizado.

Respuesta

Respuesta de ejemplo

Respuesta
{
  "id": "abcfde09817263847cdaef8493018fef",
  "clave_acceso":"2802201501091000000000120010010000100451993736618",
  "ambiente":1,
  "tipo_emision":1,
  "secuencial":50,
  "fecha_inicio_transporte":"2015-02-28T11:28:56.782Z",
  "fecha_fin_transporte":"2015-02-28T11:28:56.782Z",
  "emisor":{
    "ruc":"0910000000001",
    "obligado_contabilidad":true,
    "contribuyente_especial":"12345",
    "nombre_comercial":"XYZ Corp",
    "razon_social":"XYZ Corporación S.A.",
    "direccion":"Av. Primera 234 y calle 5ta",
    "establecimiento":{
      "punto_emision":"002",
      "codigo":"001",
      "direccion":"Av. Primera 234 y calle 5ta"
    }
  },
  "informacion_adicional":{
    "Tiempo de entrega":"5 días"
  },
  "transportista":{
    "email":"[email protected]",
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "telefono":"04 6029400",
    "placa":"GSM-0123"
  },
  "destinatarios": [{
    "identificacion":"0987654321",
    "tipo_identificacion":"05",
    "razon_social":"Juan Pérez",
    "direccion":"Calle única Numero 987",
    "email":"[email protected]",
    "telefono":"046029400",
    "fecha_emision_documento_sustento": "2015-02-27T11:28:56.782Z",
    "numero_documento_sustento": "001-001-000000008",
    "numero_autorizacion_documento_sustento": "0123456789",
    "motivo_traslado": "Venta",
    "tipo_documento_sustento": "01",
    "ruta": "GYE - UIO",
    "documento_aduanero_unico": "",
    "codigo_establecimiento_destino": "001",
    "items": [{
      "cantidad": 1.0,
      "codigo_principal": "SPS",
      "codigo_auxiliar": "001",
      "descripcion": "Playstation 4",
      "detalles_adicionales": {
        "numero": "DFGDG2342-2",
        "serie": "1-2014-2"
      }
    }]
  }]
}

Retorna un objeto tipo guía de remisión que incluye un nuevo parámetro id, el cual identifica de manera única a la guía de remisión. El campo clave_acceso generado también se incluirá como parte de la respuesta. Sí la guía de remisión ya está autorizada se retornará un error.

Retenciones

POST /ats-retentions/issue

Liquidaciones

POST /purchase-settlements/issue