Brasil: Métodos y Parámetros (API)
Autenticación
NDD soporta los dos métodos de autenticación de la API de Gosocket. No son alternativas del mismo endpoint: cada método vive en una versión distinta de la URL.
| Basic Auth | OAuth 2.0 | |
|---|---|---|
| Versión de endpoint | /api/v1/Document/... | /api/v2/Document/... |
| Cómo se envía | Header Authorization, usuario = API Key, contraseña = API Secret, en cada petición | Bearer token obtenido en /oauth2/token (client_id = API Key, client_secret = API Secret); vence tras un tiempo limitado y hay que renovarlo |
| Credenciales | Se generan en el portal de Gosocket | Las mismas credenciales del portal de Gosocket — no hay que solicitar nada adicional |
No mezcles versiones dentro de una misma integración
Los tres métodos de NDD (SendDocumentToAuthority, GetDocument, ChangeDocumentStatus) están disponibles en v1 y en v2 con el mismo contrato de request/response — solo cambia el segmento de versión en la URL y el mecanismo de autenticación. Elige una versión para toda la integración; no combines llamadas v1 con v2 usando la misma sesión.
Para el paso a paso de cómo obtener y renovar el token OAuth 2.0 (parámetros de /oauth2/token, vigencia, cómo usarlo como Bearer Token), consulta la referencia general de autenticación — aplica igual para NDD.
Ambientes
Basic Auth — v1
QA / SANDBOX
https://developers-sbx.gosocket.net/api/v1/DocumentPRODUCCIÓN
https://developers.gosocket.net/api/v1/DocumentOAuth 2.0 — v2
QA / SANDBOX
https://developers-sbx.gosocket.net/api/v2/DocumentPRODUCCIÓN
https://developers.gosocket.net/api/v2/DocumentMétodos disponibles
SendDocumentToAuthorityPOSTEnvía un documento electrónico a la autoridad fiscal (SEFAZ o Prefeitura) vía NDD.GetDocumentPOSTConsulta el estado y metadata de un documento registrado en la plataforma Gosocket.ChangeDocumentStatusPOSTEjecuta eventos sobre un documento: cancelación, carta de corrección, confirmación de operación, entre otros.