Objetivo

API para interactuar con la plataforma de facturación electrónica FEU de Surtec.
Acciones posibles:

1. Crear un comprobante fical electrónico (CFE), de cualquier tipo.

2. Consultar el estado de los CFE creados, con respecto al envío a DGI.

3. Consultar las facturas o comprobantes de compras, recibidos por ser receptor electrónico.

Autenticación

La autenticación se realizará usando Bearer Token
Un usuario obtiene un token que podrá usar para todas las empresas que tenga privilegios.
La URL para generación de Tokens es (será):

• Test: https://auth-test.facturaelectronica.com.uy/token

Solicitar token de acceso

Dos modos: 1. Nombre de usuario y contraseña 2. Token de refresco
Los tokens obtenidos de los servicios de autentificación solo serán reconocidos y utilizables con su correspondiente ambiente. Un token obtenido del sitio de test no funcionará en el sitio de producción y viseversa.

Solicitud con nombre de usuario y contraseña

Se utiliza como punto de entrada inicial al sistema, luego de obtener el primer conjunto de tokens, se prefiere el uso del segundo modo para las subsecuentes solicitudes.

Parámetros de Entrada

Solicitud con token de refresco

Modo principal para la obtención de token de acceso

Parámetros de Entrada

Parámetros de Salida

Estados y errores

La API utiliza HTTP Status Code pare indicar éxito o error en la llamada. Para ver el detalle del error, ver el cuerpo de la respuesta.

Respuesta

{
    "tipo": string,
    "tipo_codigo": number,
    "detalle": string
}

O puede ser:

{
     "tipo": string,
     "tipo_codigo": number,
     "detalle":{
         "parametro": string,
         "errores": string[]
     }
}

Ejemplos

POST: https://auth-test.facturaelectronica.com.uy/token

Petición con nombre de usuario y contraseña

{ "grant_type": "password", "username": "usuario", "password": "1234-abc" }

Petición con token de refresco

{ "grant_type": "refresh_token", "refresh_token": REFRESHTOKEN }

Respuesta

 { "access_token": ACCESSTOKEN, "token_type": "bearer", "refresh_token": REFRESHTOKEN }

1. Crear un comprobante fiscal electrónico (CFE)

La URL para crear comprobantes es:

• Test: https://api-test.facturaelectronica.com.uy/comprobantes/crear

Se solicita crear un comprobante fiscal electrónico, según los parámetros especificados. Devuelve un identificador del comprobante cuando tiene éxito.

Parámetros de Entrada

Parámetros de Salida

Detalles del sello digital

En el ángulo inferior izquierdo del documento deberá tener impreso:

• el QR-Code:
  • Tamaño: mínimo de 22 x 22 mm con un margen de 3mm en los lados del sello
  • Tamaño máximo de 30 x 30 mm con un margen de 5mm en los lados del sello.
• Debajo del QR-Code:
  • la leyenda “Código de seguridad” (opcionalmente puede imprimirse en forma abreviada)
  • y los 6 primeros caracteres del hash.
• Datos que contiene el QR-Code:
  • Link al Portal de e-factura con los siguientes parámetros:
    • Nº de RUC emisor;
    • Tipo de CFE; o Nº de comprobante (Serie y Nº);
    • Monto: (Remito “0”, Resguardo “A-C125” , e-Remito de Exportación “A-C124” y resto “A-C130”);
    • Fecha de firma del CFE (dd/mm/yyyy);
    • Código de seguridad del CFE (hash SHA-2). El link tendrá la siguiente forma: https://www.efactura.dgi.gub.uy/consultaQR/cfe?ruc,tipoCFE,serie,nroCFE,monto,fecha,hash

Ejemplo

POST: https://api-test.facturaelectronica.com.uy/comprobantes/crear

Enviar en el encabezado:

Authorization: Bearer [access-token-otorgado] 
Content-Type: application/json
X-Emisor: "nro de rut del emisor" 

Emisión de un e-ticket sin receptor

{
    "sucursal": 1,
    "tipo_comprobante": 101,
    "forma_pago": 1,
    "moneda": "UYU",
    "cod_montos_brutos": 1,
    "fecha_comprobante": "2019-02-18",
    "items": [
        {
            "cantidad": 1,
            "concepto": "Joystick Ergonómico",
            "precio": 1356.3,
            "indicador_facturacion": 3,
            "unidad": "Un"
        }
    ]
}

Emisión de nota de crédito de e-ticket sin receptor

 {
 "sucursal": 1, 
 "tipo_comprobante": 102, 
 "forma_pago": 1,  
 "moneda": "UYU", 
 "cod_montos_brutos": 1, 
 "items": [
 	{
	"cantidad": 1, 
	"concepto": "Anula ticket A-1", 
	"precio": 1356.3, 
	"indicador_facturacion": 3,
	"unidad": "Un"
 } ] 

 "referencias": [ 
 {
  "tipo_comprobante": 101,
  "serie": "A", "numero": 1 
 } ] 
}

Emisión de una e-factura con receptor

{
    "sucursal": 1,
    "tipo_comprobante": 111,
    "forma_pago": 1,
    "moneda": "UYU",
    "cod_montos_brutos": 1,
    "fecha_comprobante": "2019-02-18",
    "cliente": {
        "tipo_doc": 2,
        "cod_pais_doc": "UY",
        "nro_doc": "219999830019",
        "nombre": "ACME S.A."
    },
    "items": [{
        "cantidad": 1,
        "concepto": "Joystick Ergonómico",
        "precio": 1356.3,
        "indicador_facturacion": 3,
        "unidad": "Un"
    }]
}

Respuestas

{
    "id": 488751,
    "comprobante_tipo": 0,
    "serie": "A",
    "numero": 2209,
    "importe_total": 1356.3,
    "hash": "m9May0sG7BBzXWMPLdSrxOOGL6E=",
    "cae_numero": 90180421560,
    "cae_rango_inicio": 2001,
    "cae_rango_final": 90000,
    "cae_vencimiento": "2030-03-03T00:00:00",
    "url": "https://www.efactura.dgi.gub.uy/consultaQR/cfe?216868680019,101,A,2209,1358.30,26/04/2021,m9May0sG7BBzXWMPLdSrxOOGL6E%3D"
}

Emisión de un e-ticket con receptor y retención

{ 
"sucursal": 1, 
"tipo_comprobante": 101,
 "forma_pago": 1, 
"sucursal": 1, 
"moneda": "UYU", 
"cod_montos_brutos": 1, 
"fecha_comprobante": "2019-07-08", 
"cliente": 
{ "tipo_doc": 3,
 "cod_pais_doc": "UY", 
"nro_doc": "36000157", 
"denominacion": "PEPE CORVINA" }, 
"items": [ { 
    "cantidad": 1, 
    "concepto": "Alquileres Varios",
    "precio": 12563, 
    "indicador_facturacion": 1,
    "retencion_percepcion": [ { 
        "codigo":1146171,
        "informacion_adicional": "RET. S/ARREND",
        "valor": 1507.56
                            }],
    "unidad": "N/A"
        }]
}

Respuestas

{
    "id": 99781,
    "serie": "A",
    "numero": 101,
    "hash": "yn/cUop+p8SZC1LwG2+4ktyJlzY=",
    "cae_numero": 90180421860,
    "cae_rango_inicio": 101,
    "cae_rango_final": 1000,
    "cae_vencimiento": "2020-07-26T00:00:00",
    "url": "https://www.efactura.dgi.gub.uy/consultaQR/cfe?170005160013,101,A,101,12563.00,08/07/2019,yn/cUop+p8SZC1LwG2+4ktyJlzY="
}

Tablas Tabla de Tipos de comprobante (DGI)