Usar web service factura MiPyME via API
Con pocas líneas de código
Consumir los web services de ARCA puede ser un poco complicado, por eso vamos a utilizar la API de Afip SDK, que nos permite conectarnos a los web services de ARCA sin complicarnos con el uso de SOAP y la autenticación.
Obtener la autorización
Lo primero que tenemos hacer es obtener el “Token authorization”, que seria la autorización en ARCA.
Para usar los web services de ARCA, se requiere un certificado digital, con Afip SDK puedes integrarte en modo desarrollo usando el CUIT 20409378472 sin necesidad de obtener un certificado, para poder integrarte lo más rápido posible.
Te dejo este enlace por si luego quieres usar tu propio certificado para desarrollo.
Debemos ejecutar una solicitud POST al endpoint
https://app.afipsdk.com/api/v1/afip/auth
{
"environment": "dev",
"tax_id": "20409378472",
"wsid": "wsfecred"
}
Utilizamos el web service id wsfecred "wsid": "wsfecred", el cual corresponde al web service factura MiPyME.
En la pestaña “API” de la documentacion podes consultar todos los parametros del endpoint.
Como respuesta nos devolverá:
{
"expiration": "2024-07-13T00:42:59.845Z",
"token": "PD94bWwgd...",
"sign": "kEaCwSs36hpe..."
}
Aquí tenemos el token y sign que nos dio ARCA para usar el web service factura MiPyME. No es necesario que lo guardemos, Afip SDK se encarga de esto por nosotros, debemos solicitarlo antes de cada llamada a los métodos del web service.
Llamar al web service
En el manual del web service pueden encontrar los métodos disponibles
Para este ejemplo vamos a llamar al metodo consultarMontoObligadoRecepcion.
Debemos ejecutar una solicitud POST al endpoint
https://app.afipsdk.com/api/v1/afip/requests
{
"environment": "dev",
"method": "consultarMontoObligadoRecepcion",
"wsid": "wsfecred",
"params": {
"authRequest": {
"token": "{{token}}",
"sign": "{{sign}}",
"cuitRepresentada": "20409378472"
},
"cuitConsultada": "20054100605",
"fechaEmision": "2024-03-03"
}
}
Debemos reemplazar {{token}} y {{sign}} con los que obtuvimos anteriormente.
En la pestaña “API” de la documentacion podes consultar todos los parametros del endpoint.
En la respuesta, nos devolverá la respuesta del web service.
{
"consultarMontoObligadoRecepcionReturn": ...,
}
Con esto ya podemos conectarnos al web service factura MiPyME a través de la API.
Lo único que nos queda es pasar a modo producción.
Ante cualquier duda o pregunta al respecto, pueden resolverla rápidamente dentro de la Comunidad Afip SDK. Además, puedes unirte para estar al tanto de las novedades y problemas técnicos al usar los servicios de ARCA.
