{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"700a0e47-03af-4d81-a9f8-509ffc01df4e","name":"🔌API Suasor Fiscal","description":"Documentación de la API fiscal de Summar para integrarse con Suasor.\n\nPermite enviar a Suasor los códigos de IVA y de retención del programa del cliente, sus movimientos de IVA y de retención y sus saldos. Con ellos, el despacho prepara y presenta desde Suasor los modelos de IVA e IGIC, las retenciones, otras declaraciones informativas, el Impuesto sobre Sociedades y las cuentas anuales.\n\nLos datos no entran en la contabilidad: entran en el módulo fiscal de Suasor, separados por cliente. No hay que activar ninguna empresa. Los movimientos no se modifican: se eliminan y se vuelven a crear.\n\nTodas las llamadas deben realizarse con el \"id\" de la empresa de sistema con la que se quiere integrar. Para obtener el \"id\" de la empresa de sistema consultar \"companies\".\n\nLa autenticación es básica, con un usuario y su clave de acceso al servicio web. Al activar la API, Summar by Silae entrega un usuario de prueba. Los usuarios definitivos los crea el despacho en Suasor, uno por cada programa que se conecta, y se los entrega a quien gestiona ese programa.\n\n# **🧭 Por dónde empezar**\n\n1. \"companies\": el \"id\" de la empresa de sistema ({{systemCompanyId}}).\n    \n2. \"customers\" y \"activities\": el cliente ({{customerId}}) y su actividad.\n    \n3. \"vatSetups\" y \"withholdingSetups\": los códigos de IVA y de retención del programa, uno por cada tipo de operación.\n    \n4. \"vatEntries\": los movimientos de IVA.\n    \n5. \"withholdings\": los movimientos de retención.\n    \n6. \"balances\": los saldos, agrupados por cuenta y fecha.\n    \n\nEl despacho asigna cada código a su casilla y a su modelo en Suasor (Configuración IVA y Configuración retenciones). Si un código no está asignado, el movimiento entra pero no sale en la declaración.\n\nSi \"customers\" no devuelve nada, el usuario no tiene clientes asignados en «Usuarios API Fiscal».\n\n# **🔢 Versiones**\n\n- v1.0: 01/09/2025 - Versión inicial\n    \n- v1.1: 11/2026 - Revisión de las descripciones\n    \n\n# **🧪 Pruebas de la API**\n\nPara probar las diferentes funciones, con el botón \"Run in Postman\" se pueden probar las funciones en la aplicación de Windows de Postman o directamente en un navegador, y allí se pueden informar las variables y ejecutar cada función para ver el resultado.\n\n# **⚙️ Variables de la API**\n\nAntes de ejecutar los endpoints, asegúrate de definir las siguientes variables a nivel de \"Environment\":\n\n- {{systemCompanyId}}: \"id\" de la empresa sistema de Suasor. Necesario para cualquier integración/consulta.\n    \n- {{baseUrl}}: URL base de la API (ej. \"[https://servidor:7048/instancia/api/summar](https://servidor:7048/instancia/api/summar)\"). El puerto habitual es el 7048 y lo confirma Summar by Silae en cada instalación.\n    \n- {{user}}: usuario de la API. Lo crea el despacho en Suasor. En las pruebas, el usuario de prueba que entrega Summar by Silae.\n    \n- {{password}}: clave de acceso al servicio web de ese usuario. No es la contraseña de un usuario normal de Suasor.\n    \n- {{customerId}}: \"id\" del cliente. Necesario para enviar movimientos de IVA, movimientos de retención y movimientos contables a Suasor y poder realizar consultas.\n    \n\n# **💡 Consejos prácticos**\n\nA continuación se presentan recomendaciones útiles para optimizar tus consultas OData en la API fiscal de Suasor.\n\n**Recomendaciones:**\n\n- Sincronización continua: envía los movimientos cada cierto tiempo, no solo al cierre del periodo.\n    \n\n**Ayudas:**\n\n- Utilizar los endpoints \"metadata\" para tener más información sobre los distintos endpoints que ofrece la API\n    \n- Documentación oficial de OData:\n    \n    - [https://www.odata.org/getting-started/basic-tutorial/](https://www.odata.org/getting-started/basic-tutorial/)\n        \n    - [Using filters with API/OData calls - Business Central | Microsoft Learn](https://learn.microsoft.com/es-es/dynamics365/business-central/dev-itpro/developer/devenv-connect-apps-filtering)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"54161999","team":15190839,"collectionId":"700a0e47-03af-4d81-a9f8-509ffc01df4e","publishedId":"2sBYHaMwMh","public":true,"publicUrl":"https://apisuasor-fiscal.summarbysilae.es","privateUrl":"https://go.postman.co/documentation/54161999-700a0e47-03af-4d81-a9f8-509ffc01df4e","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Permite enviar movimientos de iva, retención y balances para presentar los distintos impuestos."},{"name":"title","value":"API Suasor Fiscal"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/64bf53f4-7fef-4943-9963-105ccedb3e7d/aW1hZ2VuICgyKS5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/64bf53f4-7fef-4943-9963-105ccedb3e7d/aW1hZ2VuICgyKS5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.12","publishDate":"2026-11-11T15:16:21.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"API Suasor Fiscal","description":"Permite enviar movimientos de iva, retención y balances para presentar los distintos impuestos."},"logos":{"logoLight":"https://content.pstmn.io/64bf53f4-7fef-4943-9963-105ccedb3e7d/aW1hZ2VuICgyKS5wbmc=","logoDark":"https://content.pstmn.io/64bf53f4-7fef-4943-9963-105ccedb3e7d/aW1hZ2VuICgyKS5wbmc="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://postman-image-service.postman.com/api/cloudinary-proxy/postman/image/upload/t_team_logo_pubdoc/v1/team/46251b563559223bb14ea8ba2d4940f349c3a323140b1264fe798f893d58ebf0","favicon":"https://summarbysilae.es/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://apisuasor-fiscal.summarbysilae.es/view/metadata/2sBYHaMwMh"}