Extraer datos de la Sunat
Ingresaste un RUC, deseas importar los datos desde SUNAT?
Esta opción está disponible gracias a RUC.com.pe
Documentación - Integración
Tocapu Api
Esta API REST te permitirá subir documentos, crear carpetas y proyectos.
Tocapu API V1
Tocapu API
Ponemos a tu disposición esta API-REST que te permitirá integrar tu aplicación muy rapidamente.
Autenticación
Para poder empezar a usar la aplicación necesita una RUTA y un TOKEN.
Una vez que tengas tu cuenta de PAGO busca la opción “Autenticación”, esta es una manera de proteger Tocapu de accesos no autorizados.
Ejemplos:
- RUTA: https://api.tocapu.pe/api/v1/t82fxQ3XRf
- TOKEN: eyJhbGciOiJIUzI1NiJ9
Enviar a la RUTA una solicitud POST, incluir en “Authorization” de la cabecera (Header) el Token, junto con un Content-Type.
--METHOD
POST
--HEADER
Authorization ENVIAR_TOKEN_AQUI
Content-Type application/json
--BODY
{"operacion": "subir_documento", Etc...}Adjuntar en el CUERPO o BODY el archivo JSON de la solicitud.
IMPORTANTE: Todas las solicitudes que se hacen a la RUTA son con el método POST. No olvides reemplazar ENVIAR_TOKEN_AQUI con tu TOKEN.
Herramientas recomendadas:
Algunas herramientas que podrían ser de utilidad son:
- Probar API: https://insomnia.rest/download
- Codificar archivo en BASE64 o viceversa: https://www.64baser.com/encode/upload/
Si necesitas ayuda no dudes en enviarnos un ticket desde https://ayuda.llama.pe/ticket.
Operaciones
Las operaciones o métodos disponibles son los siguientes.
crear_carpeta
Este método permite crear carpetas en la plataforma de Tocapu.pe
-
JSON DE ENVÍO
JSON de envío
{ "operacion": "crear_carpeta", "nombre": "Nueva carpeta", "descripcion": "", "destacado": false, "proyecto": "P2001101001" }
Descripción
Claves Valores (descripción) Tipo de dato operacion Debe ser “crear_carpeta” String nombre Un nombre de la carpeta String descripcion Descripción del documento Text destacado Prioridad de la carpeta Boolean proyecto Para anexar el proyecto que tienes creado String -
JSON DE RESPUESTA
JSON de respuesta
{ "success": true, "mensaje": "Carpeta creada correctamente", "codigo": "C2001101001" }
Descripción
Atributo Descripción success Siempre será true. mensaje Mensaje de respuesta. codigo Código de la solicitud.
subir_archivo
Este método permite subir archivos en la plataforma de Tocapu.pe
-
JSON DE ENVÍO
JSON de envío
{ "operacion": "subir_archivo", "carpeta": "C200206007", "nombre": "archivo1.pdf", "descripcion": "", "forzar": false, "archivo": "ZIPbase64", "entity": { "documento_tipo": "1", "documento_numero": "20553510661", "denominacion": "LLAMA.PE SA", "razon_comercial": "", "direccion": "", "telefono": "", "email": "", "email_2": "", "email_3": "" } }
Descripción
Claves Valores (descripción) Tipo de dato operacion Debe ser “subir_archivo” String carpeta Código de la carpeta String nombre Nombre de la carpeta String descripcion Descripción de la carpeta Text forzar Reemplazar la solicitud. Para reemplazar la solicitud, debe estar en true. Boolean archivo Archivo pdf zipeado en base64. Array documento_tipo Tipo de identificación (RUC, DNI, CE, Pasaporte, etc) Array documento_numero Número de identificación Array denominacion Nombre de la identificación Array razon_comercial Si es RUC, el nombre de la razón comercial (opcional) Array direccion Dirección fiscal de identificación Array telefono Número de teléfono Array email Correo electrónico Array -
JSON DE RESPUESTA
JSON de respuesta
{ "success": true, "mensaje": "Archivo subido correctamente", "nombre": "archivo1.pdf", "codigo": "A200201001" }
Descripción
Atributo Descripción success Siempre será true. mensaje Mensaje de respuesta. nombre Nombre del documento. codigo Código de la solicitud.
crear_proyecto
Este método permite crear proyectos en la plataforma de Tocapu.pe
-
JSON DE ENVÍO
JSON de envío
{ "operacion": "crear_proyecto", "nombre": "Nuevo proyecto", "descripcion": "", "destacado": false }
Descripción
Claves Valores (descripción) Tipo de dato operacion Debe ser “crear_proyecto” String nombre Un nombre del proyecto String descripcion Descripción del proyecto Text destacado Etiquetar el proyecto como prioritario Boolean -
JSON DE RESPUESTA
JSON de respuesta
{ "success": true, "mensaje": "Proyecto creado correctamente", "codigo": "P2001101001" }
Descripción
Atributo Descripción success Si esta conforme, sera true mensaje Mensaje de respuesta. codigo Código de la solicitud.
Manejo de errores
Los errores de la aplicación responden de la siguiente manera.
{
"error": "El dato ingresado no es correcto"
}Los errores se describen en el campo "error".
Recordar que las respuestas también incluyen en la cabecera códigos http:
- 400 – Bad Request.
- 401 – Authorization Required.
- 403 – Forbidden.
- 404 – Not Found.
- 500 – Internal Server Error.
- 502 – Bad Gateway.