/personas

Endpoints para el envío y anulación de documentos

sendBill

POST URL /personas/v1/sendBill

Envío de documentos

Request Body

Name	Type	Description
personaId*	string	Identificador de tu empresa
personaToken*	string	Token de acceso de tu empresa
fileName*	string	Nombre que usaremos para el archivo XML según parámetros de SUNAT. RRRRRRRRRRR-TT-SSSS-CCCCCCCC Donde: R = RUC (11 dígitos) T = Código de tipo de documento (2 dígitos) S = Serie (4 caracteres) C = Número correlativo (8 dígitos)
customerEmail	string	Email del adquiriente. Si lo pones le enviaremos el documento luego de ser emitido.
documentBody*	object	Objeto con todos los datos del documento

200: OK El valor status esperado es PENDIENTE

{
    "status": "PENDIENTE",
    "documentId": "5d4g1e88b30104056706dffe"
}

400: Bad Request Si el status es diferente a PENDIENTE entonces la petición fracasó. Los detalles del error estarán en el objeto "error": {}

{
    "status": "ERROR",
    "error": {} // objeto con datos del error
}

/personas/v1/voidBill

voidBill

POST URL /personas/v1/voidBill

Anulación de documentos

Request Body

Name	Type	Description
personaId*	string	Identificador de tu empresa
personaToken*	string	Token de acceso de tu empresa
reason*	string	Motivo de la anulación (3 - 100 caracteres)
documentId*	string	Identificador del documento que se va a anular

200: OK El valor status esperado es PENDIENTE

{
    "status": "PENDIENTE",
    "documentId": "5d4g1e88b30104056706dffe"
}

400: Bad Request Si el status es diferente a PENDIENTE entonces la petición fracasó. Los detalles del error estarán en el objeto "error": {}

{
    "status": "ERROR",
    "error": {} // objeto con datos del error
}

lastDocument

POST URL /personas/lastDocument

Obtener el número correlativo

Request Body

Name	Type	Description
personaId*	string	Identificador de tu empresa
serie*	string	Serie (4 caracteres)
type*	string	Código de tipo de documento (2 dígitos)
personaToken*	string	Token de acceso de tu empresa

200: OK

{
    "personaId": "5f6cd73425f5c52d375dd55c",
    "production": true,
    "type": "01",
    "serie": "F001",
    "lastNumber":"00000001",
    "suggestedNumber":"00000002"
}

Los endpoints que solo funcionan en PRODUCCION:

/getRUC

/getDNI

getRUC

GET URL /personas/:personaId/getRUC?ruc=[:ruc]&personaToken=[:personaToken]

Obtener los datos de un número de RUC (solo en PRODUCCION)

Path Parameters

Name	Type	Description
personaId*	string	Identificador de tu empresa

Query Parameters

Name	Type	Description
ruc*	string	RUC (11 dígitos)
personaToken*	string	Token de acceso de tu empresa

200: OK

{
    "success": true,
    "data": {
        "ruc": "20123456789",
        "nombre": "LOBITOS S.A.C",
        "estado": "ACTIVO",
        "condicion": "HABIDO",
        "domicilio": {
            "direccion": "JIRON UNBAN 322",
            "distrito": "LIMA",
            "provincia": "LIMA",
            "departamento": "LIMA",
            "ubigeo": "150101"
        },
        ...
    },
    "source": 1
}

get

getDNI

GET URL /personas/:personaId/getDNI?dni=[:dni]&personaToken=[:personaToken]

Obtener los datos de un número de DNI (solo en PRODUCCION)

Path Parameters

Name	Type	Description
personaId*	string	Identificador de tu empresa

Query Parameters

Name	Type	Description
dni*	string	DNI (8 dígitos)
personaToken*	string	Token de acceso de tu empresa

200: OK

{
    "success": true,
    "data": {
        "dni": "12345678",
        "nombre": "ANTONELLA ALEXANDRA",
        "apellido_paterno": "ROMANO",
        "apellido_materno": "PEREIRA",
        "domicilio": {
            "direccion": "CALLE LAS GARZAS 123",
            "distrito": "MAGDALENA DEL MAR",
            "provincia": "LIMA",
            "departamento": "LIMA",
            "ubigeo": "150120"
        }
    },
    "source": 1
}