Ingresaste un RUC, deseas importar los datos desde SUNAT?
Esta opción está disponible gracias a RUC.com.pe
Esta API REST te permitirá subir documentos, crear carpetas y proyectos.
Tocapu API
Ponemos a tu disposición esta API-REST que te permitirá integrar tu aplicación muy rapidamente.
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:
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:
Si necesitas ayuda no dudes en enviarnos un ticket desde https://ayuda.llama.pe/ticket.
Las operaciones o métodos disponibles son los siguientes.
Este método permite crear carpetas en la plataforma de Tocapu.pe
{
"operacion": "crear_carpeta",
"nombre": "Nueva carpeta",
"descripcion": "",
"destacado": false,
"proyecto": "P2001101001"
}
| 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 |
{
"success": true,
"mensaje": "Carpeta creada correctamente",
"codigo": "C2001101001"
}
| Atributo | Descripción |
|---|---|
| success | Siempre será true. |
| mensaje | Mensaje de respuesta. |
| codigo | Código de la solicitud. |
Este método permite subir archivos en la plataforma de Tocapu.pe
{
"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": ""
}
}
| 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 |
| Correo electrónico | Array |
{
"success": true,
"mensaje": "Archivo subido correctamente",
"nombre": "archivo1.pdf",
"codigo": "A200201001"
}
| Atributo | Descripción |
|---|---|
| success | Siempre será true. |
| mensaje | Mensaje de respuesta. |
| nombre | Nombre del documento. |
| codigo | Código de la solicitud. |
Este método permite crear proyectos en la plataforma de Tocapu.pe
{
"operacion": "crear_proyecto",
"nombre": "Nuevo proyecto",
"descripcion": "",
"destacado": false
}
| 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 |
{
"success": true,
"mensaje": "Proyecto creado correctamente",
"codigo": "P2001101001"
}
| Atributo | Descripción |
|---|---|
| success | Si esta conforme, sera true |
| mensaje | Mensaje de respuesta. |
| codigo | Código de la solicitud. |
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: