Documentación Métodos REST
El registro de la empresa es el primer paso para poder iniciar el proceso de Cesión, el cual nos brindará su Password de conexión a la Api Rest, obteniendo el resultado de esta forma:
POST http://www.appoctava.cl/apirestcesion/RegistraCedente
//Parametros de entrada
/*
RUT = Rol Único Tributario o identificación tributaria.
RAZONSOCIAL = Atributo legal que figura en la escritura o documento de constitución
que permite identificar a una persona jurídica y demostrar su constitución legal.
RUTAUTORIZADOSII = RUT Autorizado o Representante Legaol.
NOMBREAUTORIZADOSII = Persona natural que actúa por cuenta de un contribuyente, sea éste persona natural
o jurídica, estando facultada para ello legal o por acuerdo entre las partes.
CERTDIGBASE64 = CERTIFICADO DIGITAL,Esta firma es el equivalente electrónico de la cédula de
identidad, tiene el objetivo de permitir a los representantes de las empresas
autentificarse electrónicamente ante el SII.
PASSCERTDIG = Password de Certificado Digital.
INTEGRADOR = RUT del integrador que contrato el servicio api de cesión y re-cesión electrónica.
PASSWORDINTEGRADOR = PASSWORD del integrador que contrato el servicio api de cesión y re-cesión electrónica.
*/
BODY:
{
"RUT":"17571019-1",
"RAZONSOCIAL": "octava software spa",
"RUTAUTORIZADOSII": "17571019-1",
"NOMBREAUTORIZADOSII": "moises osorio",
"CERTDIGBASE64": "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",
"PASSCERTDIG": "password cd",
"INTEGRADOR": "RUT del integrador que contrato el servicio api de cesión y re-cesión electrónica",
"PASSWORDINTEGRADOR": "PASSWORD del integrador que contrato el servicio api de cesión y re-cesión electrónica."
}
OUTPUT:
{
"status": "exito",
"message": "metodo ejecutado",
"IdResultadoFE": "0",
"ResultadoFE": "Empresa Creada.",
"PassAccesoApi": "asd123",
"FechaExpiracionCD": "2021-01-06 17:18:07"
}
RESPUESTAS (IdResultadoFE - ResultadoFE)
0 = Empresa Creada..
1 = Empresa No Creada, Password del certificado digital incorrecta.
2 = Empresa No Creada, Favor consulte al administrador del sistema.
4 = Usuario del certificado digital no autorizado para la empresa.
5 = Error con el certificado digital, favor intentar nuevamente.
6 = Error con el certificado digital y rut empresa, favor validar los datos ingresados.
RESPUESTAS PassAccesoApi:
Password Acceso Api Cesión Electrónica
Registrada nuestra empresa, con el RUT y Paswoord obtenida abtendremos nuestro Token.
POST http://www.appoctava.cl/apirestcesion/ObtenerToken
//Parametros de entrada
/*
RUTACCESOAPI = RUT EMPRESA REGISTRADA.
PASSWORDACCESOAPI = PASSWORD OBTENIDA CON EL METODO RegistraCedente.
*/
BODY:
{
"RUTACCESOAPI":"17571019-1",
"PASSWORDACCESOAPI":"asd123"
}
OUTPUT:
{
"status": "exito",
"message": "metodo ejecutado",
"DescripcionResultado": "TOK",
"Token": "b3JkakRNeEkxNG1sOVljbnJPUXNtUjVpc3ZPMk5zRWlMcGlYUWYxRGJ6SUpaaz0=",
"TiempoEjecucion": 0.36947989463806,
"FechaHoraRegistro": "2020-04-15 09:23:31"
}
* El TOKEN tiene 6 horas de vida útil antes de su expiración.
RESPUESTAS DescripcionResultado:
TOK = Token Generado Correctamente.
TERR = Datos de Acceso para Generar Token Incorrectos.
TDUP = Ya Existe un Token Activo.
TBLOQ = La empresa se encuentra bloqueada para ingresar al sistema, favor contactar a su proveedor.
RESPUESTAS Token:
TOKEN
Método que permite la carga de los DTEs al Servidor Central .
POST http://www.appoctava.cl/apirestcesion/CargaXmlCesion
//Parametros de entrada
/*
RUTAXML = XML FIRMADO ENVIADO AL S.I.I. DEL DTE A CARGAR.
AMBIENTE = 1:PRODUCCIÓN - 0:PRUEBAS
TOKEN = TOKEN OBTENIDO EN MÉTODO ObtenerToken.
$TokenObtenido = valor obtenido por el método ObtenerToken.
*/
BODY:
{
"STRINGXML": "<DTE version=\"1.0\"><Documento ID=\"F437T33\"><Encabezado><IdDoc><TipoDTE>33</TipoDTE><Folio>1</Folio><FchEmis>2013-10-23</FchEmis></IdDoc><Emisor><RUTEmisor>17571019-1</RUTEmisor><RznSoc>EMPRESA DEMO SPA</RznSoc><GiroEmis>DESARROLLO DE SOFTWARE</GiroEmis><Acteco>513100</Acteco><DirOrigen>BASCUNAN GUERRERO 57 LOCAL 1</DirOrigen><CmnaOrigen>SANTIAGO</CmnaOrigen><CiudadOrigen>SANTIAGO</CiudadOrigen></Emisor><Receptor><RUTRecep>76689863-7</RUTRecep><RznSocRecep>PALOBLANCO SA</RznSocRecep><GiroRecep>PRODUCTORA DE SERVICIOS CULTURALES</GiroRecep><DirRecep>AV LA PAZ 451 502A</DirRecep><CmnaRecep>QUILPUE</CmnaRecep><CiudadRecep>QUILPUE</CiudadRecep></Receptor><Totales><MntNeto>63531</MntNeto><MntExe>0</MntExe><TasaIVA>19</TasaIVA><IVA>12071</IVA><MntTotal>75602</MntTotal></Totales></Encabezado><Detalle><NroLinDet>1</NroLinDet><NmbItem>POLERA PERSONALIZADA</NmbItem><QtyItem>27.0</QtyItem><UnmdItem>UN</UnmdItem><PrcItem>2353.0</PrcItem><MontoItem>63531</MontoItem></Detalle><Detalle><NroLinDet>2</NroLinDet><NmbItem>POLERA PERSONALIZADA 2</NmbItem><QtyItem>27.0</QtyItem><UnmdItem>UN</UnmdItem><PrcItem>2353.0</PrcItem><MontoItem>63531</MontoItem></Detalle><Detalle><NroLinDet>3</NroLinDet><NmbItem>POLERA PERSONALIZADA 3</NmbItem><QtyItem>27.0</QtyItem><UnmdItem>UN</UnmdItem><PrcItem>2353.0</PrcItem><MontoItem>63531</MontoItem></Detalle></Documento></DTE>",
"AMBIENTE":"1",
"TOKEN":"MEh2MjdRV3NKd1hSZVBtWkVWdWtWOGVEVDJBL05uR3FqTDRNRTdLMHhWblYya0w4YXRsZTF6TzZIV1BqbFczaEV0STdTM1FySGhGN29oU0o2TGgvWnJCdVhBajlxWnlJMm8xQk9ZdXlYL3hpd2ZzUT09"
}
OUTPUT:
{
"status": "exito",
"message": "metodo ejecutado",
"DescripcionResultado": "TVAL",
"IdResultadoFE": "0",
"ResultadoFE": "XML cargado correctamente.",
"TxtCesion": "17571019-1;EMPRESA DEMO SPA;33;1;2013-10-23;75602;76689863-7;PALOBLANCO SA;1;1"
}
RESPUESTAS DescripcionResultado:
TDUP = Ya Existe un Token Activo.
TVAL = Token Válido
TEXP = Token Expirado
TINV = Token Invalido
RESPUESTAS (IdResultadoFE - ResultadoFE)
0 = XML cargado correctamente.
1 = RUT emisor del xml subido no corresponde al del emisor del token.
2= Tipo de documento no valido para cargar.
4 = No fue posible almacenar el archivo.
5 = DTE ya se encuentra cargado.
RESPUESTAS TxtCesion
Acá viene la información de o los XML cargados con este método, en el caso que fuese mas de uno este vendrá separado con | y cada dato separado por (,).
EJEMPLO:
|RUT EMISOR,RAZON SOCIAL EMISOR, TIPO DTE,FOLIO DTE,FECHA EMISION DTE,MONTO TOTAL DTE,RUT RECEPTOR,RAZON SOCIAL RECEPTOR,AMBIENTE,IDSECUENCIA||
PD: recoger o Insertar Datos en su BD, para después lograr enviar en el Método CEDER DTE
Método que permite ceder un DTE ya cargado en el Servidor Central .
POST http://www.appoctava.cl/apirestcesion/CedeDte
//Parametros de entrada
/*
FOLIO = NUMERO DE DOCUMENTO
TIPODTE = TIPO DE DOCUMENTO TRIBUTARIO
RUTEMISOR = RUT EMISOR DEL DOCUMENTO.
AMBIENTE = 1:PRODUCCIÓN - 0:PRUEBAS
DIRECCIONCEDENTE = DIRECCIÓN CEDENTE.
EMAILCEDENTE = EMAIL CEDENTE.
RUTCESIONARIO = RUT EMPRESA CESIONARIO DE LA CESIÓN.
RAZONSOCIALCESIONARIO = RAZÓN EMPRESA CESIONARIO.
DIRECCIONCESIONARIO = DIRECCION EMPRESA CESIONARIO.
EMAILCESIONARIO = EMAIL CESIONARIO.
NOMBRECONTACTO = NOMBRE DEL EJECUTIVO.
EMAILCONTACTO = EMAIL EJECUTIVO.
MONTOCEDER = MONTO TOTAL DTE A CEDER
FECHAVENCIMIENTO = FECHA VENCIMIENTO DEL DOCUMENTO.
EMAILDEUDOR = EMAIL DEUDOR DEL DOCUMENTO.
TOKEN = TOKEN OBTENIDO POR EL MÉDOTO INICIAL.
*/
BODY:
{
"FOLIO":"1",
"TIPODTE":"33",
"RUTEMISOR":"17571019-1",
"AMBIENTE":"1",
"DIRECCIONCEDENTE":"las murtas 155",
"EMAILCEDENTE":"mosorio@appoctava.cl",
"RUTCESIONARIO":"17571019-1",
"RAZONSOCIALCESIONARIO":"moises osorio",
"DIRECCIONCESIONARIO":"las murtas 155",
"EMAILCESIONARIO":"mosorio@appoctava.cl",
"NOMBRECONTACTO":"moises osorio",
"EMAILCONTACTO":"mosorio@appoctava.cl",
"MONTOCEDER":"75602",
"FECHAVENCIMIENTO":"2020-04-30",
"EMAILDEUDOR":"mosorio@appoctava.cl",
"TOKEN":"NRTdLMHhWblYya0w4YXRsZTF6TzZIV1BqbFczaEV0STdTM1FySGhGN29oU0o2TGgvWnJCdVhBajlxWnlJMm8xQk9ZdXlYL3hpd2ZzUT09"
}
OUTPUT:
{
"status": "exito",
"message": "metodo ejecutado",
"DescripcionResultado": "TVAL",
"IdResultadoFE": "0",
"ResultadoFE": "DTE cedido correctamente."
}
RESPUESTAS DescripcionResultado:
TDUP = Ya Existe un Token Activo.
TVAL = Token Válido
TEXP = Token Expirado
TINV = Token Invalido
RESPUESTAS (IdResultadoFE - ResultadoFE)
0 = DTE cedido correctamente.
1 = DTE no encontrado en nuestros registros.
2 = Error al generar cesion.
3 = DTE ya se encuentra cedido.
4 = Imposible re-ceder,no es el actual tenedor de la cesion.
Método que permite consultar estado de la cesión en el SII y obtener el archivo electrónico de cesión(AEC).
POST http://www.appoctava.cl/apirestcesion/ConsultaEstadoAEC
//Parametros de entrada
/*
FOLIO = NUMERO DE DOCUMENTO
TIPODTE = TIPO DE DOCUMENTO TRIBUTARIO
RUTEMISOR = RUT EMISOR DEL DOCUMENTO.
AMBIENTE = 1:PRODUCCIÓN - 0:PRUEBAS
TOKEN = TOKEN OBTENIDO POR EL MÉDOTO INICIAL.
*/
BODY:
{
"FOLIO":"14",
"TIPODTE":"33",
"RUTEMISOR":"17571019-1",
"AMBIENTE":"1",
"TOKEN":"WdWtWOGVEVDJBL05uR3FqTDRNRTdLMHhWblYya0w4YXRsZTF6TzZIV1BqbFczaEV0STdTM1FySGhGN29oU0o2TGgvWnJCdVhBajlxWnlJMm8xQk9ZdXlYL3hpd2ZzUT09"
}
OUTPUT:
{
"status": "exito",
"message": "metodo ejecutado",
"DescripcionResultado": "TVAL",
"IdResultadoFE": "0",
"ResultadoFE": "Anotacion de Cesion Aceptada, Envio Aceptado",
"CodigoCesion": "EOK",
"UrlAec": "https:\/\/s3.amazonaws.com\/backupdte\/17571019-1\/xmlaec\/AEC_E17571019-1T33F14C17571019-1A1.xml"
}
RESPUESTAS DescripcionResultado:
TDUP = Ya Existe un Token Activo.
TVAL = Token Válido
TEXP = Token Expirado
TINV = Token Invalido
RESPUESTAS (IdResultadoFE - ResultadoFE)
0 = Glosa cesión S.I.I.
1 = No existe cesion para los datos entregados
RESPUESTAS CodigoCesion
RSC = Rechazado por Error en Schema.
RFS = Rechazado por Firma de Sobre.
RCR = Error e caratula.
RDC = Documento invalido.
RCS = Cesión Inválida.
EOK = Envió Aceptado | CESION OK, PUEDEN PAGAR EL DTE.
EAN = Envió Anulado.
RESPUESTAS UrlAec
Retorna la ruta del xml del AEC (Archivo Electrónico de Cesión SII), Siempre y cuando el código de la cesión sea EOK.