Nota Débito (JSON)
Introducción
Autenticación
Identificador del servicio: 1. Emisión documento, 2. Recepción documento, 3. Consulta emisión, 4. Consulta recepción, 15. Manifiesto Receptor, 16. Anulación
OK. Procesado correctamente.
Credenciales inválidas
Error. Verificar mensaje de excepción y comunicarse con soporte.
Emisión de Nota Débito
Estados eDoc
Diccionario de datos
Consumo
Recibe una nota de débito electrónica emitida para su firmado, transmisión al ente de autorización y posterior envío por correo electrónico al receptor.
Ingrese cadena de autorización: JWT-Token
Estructura del documento Nota de Débito
Número aleatorio entre 000,000,001 y 999,999,999, que integra el CUFE y tiene por objetivo asegurar la privacidad de las FE emitidas
No se admite el valor “000,000,000”, ni que sea igual al campo B07. Llenar con ceros las posiciones a la izquierda.
Origen: DGI
Opcional
Min: 9 - Max: 9
001125287Código Único de Factura Electrónica
Origen: DGI
Opcional
Min: 66 - Max: 66
FE0120000155668001-2-2018-3707892023061300000002040060120011252872Tipo de emisión (01:Autorización Previa normal, 02:Autorización Previa contingencia, 03:Autorización Posterior normal, 04:Autorización Posterior contingencia)
Origen: DGI
Obligatorio
Min: 2 - Max: 2
01Fecha y hora de inicio de la operación en contingencia
Origen: DGI
Condicional
Min: 25 - Max: 25
Obligatorio si iTpEmis = 02 y/o 04
2022-01-17T09:09:00-05:00Razón de la operación en contingencia
Origen: DGI
Condicional
Min: 15 - Max: 250
Obligatorio si iTpEmis = 02 y/o 04 Si la contingencia dura más de 72 horas también debe explicar las razones para no haber regresado a la operación normal
Sin internetTipo de emisión: 01: Factura de Operación Interna 02: Factura de Importación 03: Factura de Exportación 04: Nota de Crédito Referente a una o Varias FE 05: Nota de Débito Referente a una o Varias FE 06: Nota de Crédito Genérica 07: Nota de Débito Genérica 08: Factura de Zona Franca 09: Reembolso 10: Factura de operación extranjera
Origen: DGI
Obligatorio
Min: 2 - Max: 2
01Número del documento fiscal en la serie correspondiente, de 1 a 9999999999
Origen: DGI
Obligatorio
Min: 1 - Max: 10
No se admite el valor “cero” Llenar con ceros las posiciones a la izquierda Sólo se deben colocar números y se define Alfanumérico porque debe ser rellanado con ceros (0) a la izquierda.
100Punto de Facturación del documento fiscal.
Origen: DGI
Obligatorio
Min: 1 - Max: 3
No se admite el valor “cero” Llenar con ceros las posiciones a la izquierda Sólo se deben colocar números y se define Alfanumérico porque debe ser rellanado con ceros (0) a la izquierda.
3Fecha de emisión del documento
Origen: DGI
Obligatorio
Min: 25 - Max: 25
No se admite el valor “cero” Llenar con ceros las posiciones a la izquierda Sólo se deben colocar números y se define Alfanumérico porque debe ser rellanado con ceros (0) a la izquierda.
2023-01-17T09:09:00-05:00Fecha de salida estimada de las mercancías
Origen: DGI
Condicional
Min: 25 - Max: 25
Informar cuando sea conocida
2023-01-17T09:09:00-05:00Naturaleza de la Operación 01: Venta 02: Exportación 03: Re-exportación, 04: Venta de fuente extranjera, 10: Transferencia/Traspaso 11: Devolución 12: Consignación 13: Remesa 14: Entrega gratuita 20: Compra 21: Importación
Origen: DGI
Obligatorio
Min: 2 - Max: 2
01Tipo de la operación (1: Salida o venta 2: Entrada o compra (factura de compra- para comercio informal. Ej.: taxista, trabajadores manuales))
Origen: DGI
Obligatorio
Min: 1 - Max: 1
1:Venta- para operaciones de venta ya se de productos o servicio
1Destino de la operación (1: Panamá 2: Extranjero)
Origen: DGI
Obligatorio
Min: 1 - Max: 3
1: Panamá- para ventas en el area Nacional
1Formato de generación del CAFÉ 1: Sin generación de CAFE El emisor podrá decidir generar CAFE en cualquier momento posterior a la autorización de uso de FE. 2: Cinta de papel 3: Papel formato carta
Origen: DGI
Obligatorio
Min: 1 - Max: 1
3: Papel formato carta
3Manera de entrega del CAFE al receptor 1: Sin generación de CAFE El emisor podrá decidir generar CAFE en cualquier momento posterior a la autorización de uso de FE 2: CAFE entregado para el receptor en papel 3: CAFE enviado para el receptor en formato electrónico.
Origen: DGI
Obligatorio
Min: 1 - Max: 1
3: CAFE enviado para el receptor en formato electrónico.
3Envío del contenedor para el receptor 1: normal 2: El receptor exceptúa al emisor de la obligatoriedad de envío del contenedor. El emisor podrá decidir entregar el contenedor, por cualquier razón, en momento posterior a la autorización de uso, pero no era esta su intención en el momento de la emisión de la FE.
Origen: DGI
Obligatorio
Min: 1 - Max: 1
1: normal
1Proceso de generación de la FE 1: Generación por el sistema de facturación del contribuyente (desarrollo propio o producto adquirido) 2: Generación por tercero contratado 3: Generación gratuita por tercero proveedor de solución 4: Generación gratuita por la DIRECCIÓN GENERAL DE INGRESOS en página web
Origen: DGI
Obligatorio
Min: 1 - Max: 1
2: Generación por tercero contratado
2Tipo de Sucursal (1:Mayor cantidad de Operaciones venta al detal, 2:Mayor cantidad de Operaciones venta al por mayor)
Origen: DGI
Condicional
Min: 1 - Max: 1
2:Mayor cantidad de Operaciones venta al por mayor
2Tipo de transacción de venta: 1: Venta de Giro del negocio 2: Venta Activo Fijo 3: Venta de Bienes Raíces 4: Prestación de Servicio Si no es venta, no informar este campo
Origen: DGI
Condicional
Min: 1 - Max: 1
Tipo de Venta para el vendedor: 1: Venta de Giro del negocio
1Información de interés del emisor con respeto a la FE
Origen: DGI
Opcional
Min: 0 - Max: 5000
Se puede enviar varios datos adicionales separados por punto y coma (;) y mapear en el modelo CAFE en la posición que se requiera
Informacion del emisor 1;Informacion del emisor 2Correo del responsable del documento
Origen: GS
Opcional
Min: 0 - Max: 150
[email protected]Código único del documento utilizado en ERP
Origen: GS
Opcional
Min: 0 - Max: 30
930054013130000001Usuario generó el documento
Origen: GS
Opcional
Min: 0 - Max: 30
gurusoftCódigo del documento utilizado en el ERP
Origen: GS
Opcional
Min: 0 - Max: 30
9300540131Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo1Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo2Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo3Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo4Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo5Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo6Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo7Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo8Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo9Campo con información adicional
Origen: GS
Opcional
Min: 0 - Max: 1000
Campo10Nombre de la integración
Origen: GS
Opcional
Min: 0 - Max: 100
ERP XIP de origen de la comunicación
Origen: GS
Opcional
Min: 0 - Max: 50
192.168.0.1Indica si la autorización sera false: previa o true: posterior
Origen: GS
Opcional
La petición se ha procesado correctamente. No obstante, es necesario verificar el 'estado eDoc' para confirmar si el documento electrónico ha sido autorizado o rechazado, según los estados definidos.
Credenciales inválidas o la compañía no tiene autorización para acceder.
Verificar mensaje de excepción y comunicarse con soporte.
Última actualización
¿Te fue útil?